com.fr.design.gui.itree.checkboxtree

类 CheckBoxTreeSelectionModel

java.lang.Object

javax.swing.tree.DefaultTreeSelectionModel

com.fr.design.gui.itree.checkboxtree.CheckBoxTreeSelectionModel

所有已实现的接口:

java.io.Serializable, java.lang.Cloneable, javax.swing.tree.TreeSelectionModel

public class CheckBoxTreeSelectionModel
extends javax.swing.tree.DefaultTreeSelectionModel

CheckBoxTreeSelectionModel is a selection _model based on DefaultTreeSelectionModel and use in CheckBoxTree to keep track of the checked tree paths.

作者:

Santhosh Kumar T

另请参阅:

序列化表格

字段概要

从类继承的字段 javax.swing.tree.DefaultTreeSelectionModel

changeSupport, leadIndex, leadPath, leadRow, listenerList, listSelectionModel, rowMapper, selection, SELECTION_MODE_PROPERTY, selectionMode

从接口继承的字段 javax.swing.tree.TreeSelectionModel

CONTIGUOUS_TREE_SELECTION, DISCONTIGUOUS_TREE_SELECTION, SINGLE_TREE_SELECTION

构造器概要

构造器

构造器和说明
CheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model)
CheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model, boolean digIn)

方法概要

方法

限定符和类型	方法和说明
void	addSelectionPaths(javax.swing.tree.TreePath[] paths) Overrides the method in DefaultTreeSelectionModel to consider digIn mode.
javax.swing.tree.TreeModel	getModel()
boolean	isDigIn() Gets the dig-in mode.
boolean	isPartiallySelected(javax.swing.tree.TreePath path) Tests whether there is any unselected node in the subtree of given path.
boolean	isPathSelected(javax.swing.tree.TreePath path, boolean digIn) Tells whether given path is selected. if dig is true, then a path is assumed to be selected, if one of its ancestor is selected.
boolean	isSingleEventMode()
protected void	notifyPathChange(javax.swing.tree.TreePath[] changedPaths, boolean isNew, javax.swing.tree.TreePath oldLeadSelection) Notifies listeners of a change in path. changePaths should contain instances of PathPlaceHolder.
protected void	notifyPathChange(java.util.Vector changedPaths, javax.swing.tree.TreePath oldLeadSelection)
void	removeSelectionPaths(javax.swing.tree.TreePath[] paths)
void	setBatchMode(boolean batchMode)
void	setDigIn(boolean digIn) Sets the dig-in mode.
void	setModel(javax.swing.tree.TreeModel model)
void	setSelectionPaths(javax.swing.tree.TreePath[] pPaths) Overrides the method in DefaultTreeSelectionModel to consider digIn mode.
void	setSingleEventMode(boolean singleEventMode) Single event mode is a mode that always fires only one event when you select or unselect a tree node.

从类继承的方法 javax.swing.tree.DefaultTreeSelectionModel

addPropertyChangeListener, addSelectionPath, addTreeSelectionListener, arePathsContiguous, canPathsBeAdded, canPathsBeRemoved, clearSelection, clone, fireValueChanged, getLeadSelectionPath, getLeadSelectionRow, getListeners, getMaxSelectionRow, getMinSelectionRow, getPropertyChangeListeners, getRowMapper, getSelectionCount, getSelectionMode, getSelectionPath, getSelectionPaths, getSelectionRows, getTreeSelectionListeners, insureRowContinuity, insureUniqueness, isPathSelected, isRowSelected, isSelectionEmpty, removePropertyChangeListener, removeSelectionPath, removeTreeSelectionListener, resetRowSelection, setRowMapper, setSelectionMode, setSelectionPath, toString, updateLeadIndex

从类继承的方法 java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造器详细资料

CheckBoxTreeSelectionModel

public CheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model)

CheckBoxTreeSelectionModel

public CheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model,
                          boolean digIn)

方法详细资料

getModel

public javax.swing.tree.TreeModel getModel()

setModel

public void setModel(javax.swing.tree.TreeModel model)

isDigIn

public boolean isDigIn()

Gets the dig-in mode. If the CheckBoxTree is in dig-in mode, checking the parent node will check all the children. Correspondingly, getSelectionPaths() will only return the parent tree path. If not in dig-in mode, each tree node can be checked or unchecked independently

返回:

true or false.

setDigIn

public void setDigIn(boolean digIn)

Sets the dig-in mode. If the CheckBoxTree is in dig-in mode, checking the parent node will check all the children. Correspondingly, getSelectionPaths() will only return the parent tree path. If not in dig-in mode, each tree node can be checked or unchecked independently

参数:

digIn - true to enable dig-in mode. False to disable it.

isPartiallySelected

public boolean isPartiallySelected(javax.swing.tree.TreePath path)

Tests whether there is any unselected node in the subtree of given path.

参数:

path - check if the path is partially selected.

返回:

true i fpartially. Otherwise false.

isPathSelected

public boolean isPathSelected(javax.swing.tree.TreePath path,
                     boolean digIn)

Tells whether given path is selected. if dig is true, then a path is assumed to be selected, if one of its ancestor is selected.

参数:

path - check if the path is selected.

digIn - whether we will check its descendants.

返回:

true if the path is selected.

notifyPathChange

protected void notifyPathChange(java.util.Vector changedPaths,
                    javax.swing.tree.TreePath oldLeadSelection)

覆盖:

notifyPathChange 在类中 javax.swing.tree.DefaultTreeSelectionModel

setSelectionPaths

public void setSelectionPaths(javax.swing.tree.TreePath[] pPaths)

Overrides the method in DefaultTreeSelectionModel to consider digIn mode.

指定者:

setSelectionPaths 在接口中 javax.swing.tree.TreeSelectionModel

覆盖:

setSelectionPaths 在类中 javax.swing.tree.DefaultTreeSelectionModel

参数:

pPaths - the tree paths to be selected.

addSelectionPaths

public void addSelectionPaths(javax.swing.tree.TreePath[] paths)

Overrides the method in DefaultTreeSelectionModel to consider digIn mode.

指定者:

addSelectionPaths 在接口中 javax.swing.tree.TreeSelectionModel

覆盖:

addSelectionPaths 在类中 javax.swing.tree.DefaultTreeSelectionModel

参数:

paths - the tree paths to be added to selection paths.

removeSelectionPaths

public void removeSelectionPaths(javax.swing.tree.TreePath[] paths)

指定者:

removeSelectionPaths 在接口中 javax.swing.tree.TreeSelectionModel

覆盖:

removeSelectionPaths 在类中 javax.swing.tree.DefaultTreeSelectionModel

isSingleEventMode

public boolean isSingleEventMode()

setSingleEventMode

public void setSingleEventMode(boolean singleEventMode)

Single event mode is a mode that always fires only one event when you select or unselect a tree node.

Taking this tree as an example,

 A -- a
    |- b
    |- c
 

Case 1: Assuming b and c are selected at this point, you click on a.

• In non-single event mode, you will get select-A, deselect-b and deselect-c three events
• In single event mode, you will only get select-a.

Case 2: Assuming none of the nodes are selected, you click on A. In this case, both modes result in the same behavior.

• In non-single event mode, you will get only select-A event.
• In single event mode, you will only get select-A too.

Case 3: Assuming b and c are selected and now you click on A.

• In non-single event mode, you will get select-A event as well as deselect-b and deselect-c event.
• In single event mode, you will only get select-A.

As you can see, single event mode will always fire the event on the nodes you select. However it doesn't reflect what really happened inside the selection model. So if you want to get a complete picture of the selection state inside selection model, you should use DefaultTreeSelectionModel.getSelectionPaths() to find out. In non-single event mode, the events reflect what happened inside the selection model. So you can get a complete picture of the exact state without asking the selection model. The downside is it will generate too many events. With this option, you can decide which mode you want to use that is the best for your case.

By default, singleEventMode is set to false to be compatible with the older versions that don't have this option.

参数:

singleEventMode - true or false.

notifyPathChange

protected void notifyPathChange(javax.swing.tree.TreePath[] changedPaths,
                    boolean isNew,
                    javax.swing.tree.TreePath oldLeadSelection)

Notifies listeners of a change in path. changePaths should contain instances of PathPlaceHolder.

参数:

changedPaths - the paths that are changed.

isNew - is it a new path.

oldLeadSelection - the old selection.

setBatchMode

public void setBatchMode(boolean batchMode)