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, GraphSelectionModel

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

Object
cloneWithSource(Object newSource)
Returns a copy of the receiver, but with the source being newSource.
Object
getCell()
Returns the first cell.
Object[]
getCells()
Returns the cells that have been added or removed from the selection.
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.
boolean
isAddedCell(Object cell)
Returns true if the cell identified by cell was added to the selection.
boolean
isAddedCell(int index)
Returns true if the cell identified by index was added to the selection.

Field Details

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 Details

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 Details

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 <320 || >=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-2006 Gaudenz Alder. All rights reserved.