org.jgraph.event

Class GraphSelectionEvent

public class GraphSelectionEvent extends EventObject

An event that characterizes a change in the current selection. The change is based on any number of cells. GraphSelectionListeners will generally query the source of the event for the new selected status of each potentially changed cell.

See Also: GraphSelectionListener

Field Summary
protected boolean[]areNew
For each cell identifies whether or not that cell is newly selected.
protected Object[]cells
Cells this event represents.
Constructor Summary
GraphSelectionEvent(Object source, Object[] cells, boolean[] areNew)
Represents a change in the selection of a GraphSelectionModel.
Method Summary
ObjectcloneWithSource(Object newSource)
Returns a copy of the receiver, but with the source being newSource.
ObjectgetCell()
Returns the first cell.
Object[]getCells()
Returns the cells that have been added or removed from the selection.
booleanisAddedCell()
Returns true if the first cell has been added to the selection, a return value of false means the first cell has been removed from the selection.
booleanisAddedCell(Object cell)
Returns true if the cell identified by cell was added to the selection.
booleanisAddedCell(int index)
Returns true if the cell identified by index was added to the selection.

Field Detail

areNew

protected boolean[] areNew
For each cell identifies whether or not that cell is newly selected.

cells

protected Object[] cells
Cells this event represents.

Constructor Detail

GraphSelectionEvent

public GraphSelectionEvent(Object source, Object[] cells, boolean[] areNew)
Represents a change in the selection of a GraphSelectionModel. cells identifies the cells that have been either added or removed from the selection.

Parameters: source source of event cells the paths that have changed in the selection areNew for each cell, defines whether or not that cell is newly selected

Method Detail

cloneWithSource

public Object cloneWithSource(Object newSource)
Returns a copy of the receiver, but with the source being newSource.

Parameters: newSource the new event source

Returns: the cloned event with the specified source

getCell

public Object getCell()
Returns the first cell.

Returns: the first selected cell

getCells

public Object[] getCells()
Returns the cells that have been added or removed from the selection.

Returns: added or removed cells

isAddedCell

public boolean isAddedCell()
Returns true if the first cell has been added to the selection, a return value of false means the first cell has been removed from the selection.

Returns: whether or not the first cell has been added or removed

isAddedCell

public boolean isAddedCell(Object cell)
Returns true if the cell identified by cell was added to the selection. A return value of false means the cell was in the selection but is no longer in the selection. This will raise if cell is not one of the cells identified by this event.

Parameters: cell the cell that is to be indicated as newly selected or not

Returns: true if the specified cell is newly selected

isAddedCell

public boolean isAddedCell(int index)
Returns true if the cell identified by index was added to the selection. A return value of false means the cell was in the selection but is no longer in the selection. This will raise an exception if index < 0 || >=getPaths .length.

Parameters: index the index of areNew of the cell that is to be indicated as newly selected or not

Returns: whether or not the cell is newly selected or not

Copyright (C) 2001-2009 JGraph Ltd. All rights reserved.