Class GTreeSelectionModel
- java.lang.Object
-
- javax.swing.tree.DefaultTreeSelectionModel
-
- docking.widgets.tree.internal.GTreeSelectionModel
-
- All Implemented Interfaces:
java.io.Serializable,java.lang.Cloneable,javax.swing.tree.TreeSelectionModel
public class GTreeSelectionModel extends javax.swing.tree.DefaultTreeSelectionModelThis class was created so that GTree users can know the origin of tree selections. This is useful in determining if the tree selection event occurred because the user clicked in the tree, or if an API method was called (or by an event internal to, or trigged by the GTree).As an example usage, imagine an event cycle, where a change in the tree selection causes a change in some other GUI component and changes in the other GUI component cause a change in the tree selection. In this scenario, to avoid bouncing back and forth, the TreeSelectionListener can check if the tree selection change was caused by the user or by an API call responding to the change in the other GUI component, thereby breaking the cycle.
With this selection model the user can check the origin of the event with a call to:
public void valueChanged(GTreeSelectionEvent e) { if ( e.getEventOrigin() == EventOrigin.USER_GENERATED ) { // respond to user selection } }- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description GTreeSelectionModel()
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description voidaddGTreeSelectionListener(GTreeSelectionListener listener)voidclearSelection()protected voidfireValueChanged(javax.swing.event.TreeSelectionEvent e)voidremoveGTreeSelectionListener(GTreeSelectionListener listener)voidremoveSelectionPaths(javax.swing.tree.TreePath[] paths)voidsetSelectionPaths(javax.swing.tree.TreePath[] paths, GTreeSelectionEvent.EventOrigin origin)voiduserRemovedSelectionPath(javax.swing.tree.TreePath path)This method allows the GTree's JTree to tell this selection model when a selection has been removed due to the user clicking.-
Methods inherited from class javax.swing.tree.DefaultTreeSelectionModel
addPropertyChangeListener, addSelectionPath, addSelectionPaths, addTreeSelectionListener, arePathsContiguous, canPathsBeAdded, canPathsBeRemoved, clone, getLeadSelectionPath, getLeadSelectionRow, getListeners, getMaxSelectionRow, getMinSelectionRow, getPropertyChangeListeners, getRowMapper, getSelectionCount, getSelectionMode, getSelectionPath, getSelectionPaths, getSelectionRows, getTreeSelectionListeners, insureRowContinuity, insureUniqueness, isPathSelected, isRowSelected, isSelectionEmpty, notifyPathChange, removePropertyChangeListener, removeSelectionPath, removeTreeSelectionListener, resetRowSelection, setRowMapper, setSelectionMode, setSelectionPath, setSelectionPaths, toString, updateLeadIndex
-
-
-
-
Method Detail
-
addGTreeSelectionListener
public void addGTreeSelectionListener(GTreeSelectionListener listener)
-
removeGTreeSelectionListener
public void removeGTreeSelectionListener(GTreeSelectionListener listener)
-
fireValueChanged
protected void fireValueChanged(javax.swing.event.TreeSelectionEvent e)
- Overrides:
fireValueChangedin classjavax.swing.tree.DefaultTreeSelectionModel
-
clearSelection
public void clearSelection()
- Specified by:
clearSelectionin interfacejavax.swing.tree.TreeSelectionModel- Overrides:
clearSelectionin classjavax.swing.tree.DefaultTreeSelectionModel
-
removeSelectionPaths
public final void removeSelectionPaths(javax.swing.tree.TreePath[] paths)
- Specified by:
removeSelectionPathsin interfacejavax.swing.tree.TreeSelectionModel- Overrides:
removeSelectionPathsin classjavax.swing.tree.DefaultTreeSelectionModel
-
userRemovedSelectionPath
public final void userRemovedSelectionPath(javax.swing.tree.TreePath path)
This method allows the GTree's JTree to tell this selection model when a selection has been removed due to the user clicking.Implementation Note: this method is needed because
removeSelectionPaths(TreePath[])marks all events asGTreeSelectionEvent.EventOrigin.INTERNAL_GENERATED. Our intention is to mark any tree housekeeping as internal, with user operations being marked appropriately.- Parameters:
path- the path that is to be removed
-
setSelectionPaths
public void setSelectionPaths(javax.swing.tree.TreePath[] paths, GTreeSelectionEvent.EventOrigin origin)
-
-