com.jidesoft.swing

Class LegacyCheckBoxTree

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JTree

com.jidesoft.swing.LegacyCheckBoxTree

All Implemented Interfaces:

java.awt.image.ImageObserver, java.awt.MenuContainer, java.io.Serializable, javax.accessibility.Accessible, javax.swing.Scrollable

Deprecated.

Use CheckBoxTree.

public class LegacyCheckBoxTree
extends javax.swing.JTree

This class is deprecated and provided to support compatibility with LegacyTristateCheckBox. We will not provide support for this class. You likely want to use CheckBoxTree.

CheckBoxTree is a special JTree which uses JCheckBox as the tree renderer. In addition to regular JTree's features, it also allows you select any number of tree nodes in the tree by selecting the check boxes.

To select an element, user can mouse click on the check box, or select one or several tree nodes and press SPACE key to toggle the check box selection for all selected tree nodes.

In order to retrieve which tree paths are selected, you need to call getCheckBoxTreeSelectionModel(). It will return the selection model that keeps track of which tree paths have been checked. For example DefaultTreeSelectionModel.getSelectionPaths() will give the list of paths which have been checked.

See Also:

Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected static class	LegacyCheckBoxTree.Handler Deprecated.

Nested classes/interfaces inherited from class javax.swing.JTree

javax.swing.JTree.AccessibleJTree, javax.swing.JTree.DropLocation, javax.swing.JTree.DynamicUtilTreeNode, javax.swing.JTree.EmptySelectionModel, javax.swing.JTree.TreeModelHandler, javax.swing.JTree.TreeSelectionRedirector

Nested classes/interfaces inherited from class javax.swing.JComponent

javax.swing.JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class java.awt.Container

java.awt.Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class java.awt.Component

java.awt.Component.AccessibleAWTComponent, java.awt.Component.BaselineResizeBehavior, java.awt.Component.BltBufferStrategy, java.awt.Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field and Description
protected LegacyCheckBoxTreeCellRenderer	_treeCellRenderer Deprecated.
static java.lang.String	PROPERTY_CHECKBOX_ENABLED Deprecated.
static java.lang.String	PROPERTY_CLICK_IN_CHECKBOX_ONLY Deprecated.
static java.lang.String	PROPERTY_DIG_IN Deprecated.

Fields inherited from class javax.swing.JTree

ANCHOR_SELECTION_PATH_PROPERTY, CELL_EDITOR_PROPERTY, CELL_RENDERER_PROPERTY, cellEditor, cellRenderer, editable, EDITABLE_PROPERTY, EXPANDS_SELECTED_PATHS_PROPERTY, INVOKES_STOP_CELL_EDITING_PROPERTY, invokesStopCellEditing, LARGE_MODEL_PROPERTY, largeModel, LEAD_SELECTION_PATH_PROPERTY, ROOT_VISIBLE_PROPERTY, rootVisible, ROW_HEIGHT_PROPERTY, rowHeight, SCROLLS_ON_EXPAND_PROPERTY, scrollsOnExpand, SELECTION_MODEL_PROPERTY, selectionModel, selectionRedirector, SHOWS_ROOT_HANDLES_PROPERTY, showsRootHandles, TOGGLE_CLICK_COUNT_PROPERTY, toggleClickCount, TREE_MODEL_PROPERTY, treeModel, treeModelListener, VISIBLE_ROW_COUNT_PROPERTY, visibleRowCount

Fields inherited from class javax.swing.JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class java.awt.Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface java.awt.image.ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor and Description
LegacyCheckBoxTree() Deprecated.
LegacyCheckBoxTree(java.util.Hashtable<?,?> value) Deprecated.
LegacyCheckBoxTree(java.lang.Object[] value) Deprecated.
LegacyCheckBoxTree(javax.swing.tree.TreeModel newModel) Deprecated.
LegacyCheckBoxTree(javax.swing.tree.TreeNode root) Deprecated.
LegacyCheckBoxTree(javax.swing.tree.TreeNode root, boolean asksAllowsChildren) Deprecated.
LegacyCheckBoxTree(java.util.Vector<?> value) Deprecated.

Method Summary

Modifier and Type	Method and Description
protected LegacyCheckBoxTreeCellRenderer	createCellRenderer(javax.swing.tree.TreeCellRenderer renderer) Deprecated. Creates the cell renderer.
protected LegacyCheckBoxTreeSelectionModel	createCheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model) Deprecated. Creates the CheckBoxTreeSelectionModel.
protected LegacyCheckBoxTree.Handler	createHandler() Deprecated. Creates the mouse listener and key listener used by CheckBoxTree.
javax.swing.tree.TreeCellRenderer	getActualCellRenderer() Deprecated. Gets the actual cell renderer.
javax.swing.tree.TreeCellRenderer	getCellRenderer() Deprecated. Gets the cell renderer with check box.
LegacyTristateCheckBox	getCheckBox() Deprecated. Get the CheckBox used for CheckBoxTreeCellRenderer.
LegacyCheckBoxTreeSelectionModel	getCheckBoxTreeSelectionModel() Deprecated. Gets the selection model for the check boxes.
javax.swing.tree.TreePath	getNextMatch(java.lang.String prefix, int startingRow, javax.swing.text.Position.Bias bias) Deprecated.
protected void	init() Deprecated. Initialize the CheckBoxTree.
boolean	isCheckBoxEnabled() Deprecated. Gets the value of property checkBoxEnabled.
boolean	isCheckBoxEnabled(javax.swing.tree.TreePath path) Deprecated. Checks if check box is enabled.
boolean	isCheckBoxVisible(javax.swing.tree.TreePath path) Deprecated. Checks if check box is visible.
boolean	isClickInCheckBoxOnly() Deprecated. Gets the value of property clickInCheckBoxOnly.
boolean	isDigIn() Deprecated. Gets the dig-in mode.
boolean	isSelectPartialOnToggling() Deprecated. Gets the flag indicating if toggling should select or deselect the partially selected node.
void	setCellRenderer(javax.swing.tree.TreeCellRenderer x) Deprecated.
void	setCheckBox(LegacyTristateCheckBox checkBox) Deprecated. Set the CheckBox used for CheckBoxTreeCellRenderer.
void	setCheckBoxEnabled(boolean checkBoxEnabled) Deprecated. Sets the value of property checkBoxEnabled.
void	setClickInCheckBoxOnly(boolean clickInCheckBoxOnly) Deprecated. Sets the value of property clickInCheckBoxOnly.
void	setDigIn(boolean digIn) Deprecated. Sets the dig-in mode.
void	setSelectPartialOnToggling(boolean selectPartialOnToggling) Deprecated. Sets the flag indicating if toggling should select or deselect the partially selected node.

Methods inherited from class javax.swing.JTree

addSelectionInterval, addSelectionPath, addSelectionPaths, addSelectionRow, addSelectionRows, addTreeExpansionListener, addTreeSelectionListener, addTreeWillExpandListener, cancelEditing, clearSelection, clearToggledPaths, collapsePath, collapseRow, convertValueToText, createTreeModel, createTreeModelListener, expandPath, expandRow, fireTreeCollapsed, fireTreeExpanded, fireTreeWillCollapse, fireTreeWillExpand, fireValueChanged, getAccessibleContext, getAnchorSelectionPath, getCellEditor, getClosestPathForLocation, getClosestRowForLocation, getDefaultTreeModel, getDescendantToggledPaths, getDragEnabled, getDropLocation, getDropMode, getEditingPath, getExpandedDescendants, getExpandsSelectedPaths, getInvokesStopCellEditing, getLastSelectedPathComponent, getLeadSelectionPath, getLeadSelectionRow, getMaxSelectionRow, getMinSelectionRow, getModel, getPathBetweenRows, getPathBounds, getPathForLocation, getPathForRow, getPreferredScrollableViewportSize, getRowBounds, getRowCount, getRowForLocation, getRowForPath, getRowHeight, getScrollableBlockIncrement, getScrollableTracksViewportHeight, getScrollableTracksViewportWidth, getScrollableUnitIncrement, getScrollsOnExpand, getSelectionCount, getSelectionModel, getSelectionPath, getSelectionPaths, getSelectionRows, getShowsRootHandles, getToggleClickCount, getToolTipText, getTreeExpansionListeners, getTreeSelectionListeners, getTreeWillExpandListeners, getUI, getUIClassID, getVisibleRowCount, hasBeenExpanded, isCollapsed, isCollapsed, isEditable, isEditing, isExpanded, isExpanded, isFixedRowHeight, isLargeModel, isPathEditable, isPathSelected, isRootVisible, isRowSelected, isSelectionEmpty, isVisible, makeVisible, paramString, removeDescendantSelectedPaths, removeDescendantToggledPaths, removeSelectionInterval, removeSelectionPath, removeSelectionPaths, removeSelectionRow, removeSelectionRows, removeTreeExpansionListener, removeTreeSelectionListener, removeTreeWillExpandListener, scrollPathToVisible, scrollRowToVisible, setAnchorSelectionPath, setCellEditor, setDragEnabled, setDropMode, setEditable, setExpandedState, setExpandsSelectedPaths, setInvokesStopCellEditing, setLargeModel, setLeadSelectionPath, setModel, setRootVisible, setRowHeight, setScrollsOnExpand, setSelectionInterval, setSelectionModel, setSelectionPath, setSelectionPaths, setSelectionRow, setSelectionRows, setShowsRootHandles, setToggleClickCount, setUI, setVisibleRowCount, startEditingAtPath, stopEditing, treeDidChange, updateUI

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class java.lang.Object

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

Field Detail

PROPERTY_CHECKBOX_ENABLED

public static final java.lang.String PROPERTY_CHECKBOX_ENABLED

Deprecated.

See Also:

Constant Field Values

PROPERTY_CLICK_IN_CHECKBOX_ONLY

public static final java.lang.String PROPERTY_CLICK_IN_CHECKBOX_ONLY

Deprecated.

See Also:

Constant Field Values

PROPERTY_DIG_IN

public static final java.lang.String PROPERTY_DIG_IN

Deprecated.

See Also:

Constant Field Values

_treeCellRenderer

protected LegacyCheckBoxTreeCellRenderer _treeCellRenderer

Deprecated.

Constructor Detail

LegacyCheckBoxTree

public LegacyCheckBoxTree()

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(java.lang.Object[] value)

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(java.util.Vector<?> value)

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(java.util.Hashtable<?,?> value)

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(javax.swing.tree.TreeNode root)

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(javax.swing.tree.TreeNode root,
                          boolean asksAllowsChildren)

Deprecated.

LegacyCheckBoxTree

public LegacyCheckBoxTree(javax.swing.tree.TreeModel newModel)

Deprecated.

Method Detail

init

protected void init()

Deprecated.

Initialize the CheckBoxTree.

createCheckBoxTreeSelectionModel

protected LegacyCheckBoxTreeSelectionModel createCheckBoxTreeSelectionModel(javax.swing.tree.TreeModel model)

Deprecated.

Creates the CheckBoxTreeSelectionModel.

Parameters:

model - the tree model.

Returns:

the CheckBoxTreeSelectionModel.

getCellRenderer

public javax.swing.tree.TreeCellRenderer getCellRenderer()

Deprecated.

Gets the cell renderer with check box.

Overrides:

getCellRenderer in class javax.swing.JTree

Returns:

CheckBoxTree's own cell renderer which has the check box. The actual cell renderer you set by setCellRenderer() can be accessed by using getActualCellRenderer().

getActualCellRenderer

public javax.swing.tree.TreeCellRenderer getActualCellRenderer()

Deprecated.

Gets the actual cell renderer. Since CheckBoxTree has its own check box cell renderer, this method will give you access to the actual cell renderer which is either the default tree cell renderer or the cell renderer you set using setCellRenderer(javax.swing.tree.TreeCellRenderer).

Returns:

the actual cell renderer

setCellRenderer

public void setCellRenderer(javax.swing.tree.TreeCellRenderer x)

Deprecated.

Overrides:

setCellRenderer in class javax.swing.JTree

createCellRenderer

protected LegacyCheckBoxTreeCellRenderer createCellRenderer(javax.swing.tree.TreeCellRenderer renderer)

Deprecated.

Creates the cell renderer.

Parameters:

renderer - the actual renderer for the tree node. This method will return a cell renderer that use a check box and put the actual renderer inside it.

Returns:

the cell renderer.

createHandler

protected LegacyCheckBoxTree.Handler createHandler()

Deprecated.

Creates the mouse listener and key listener used by CheckBoxTree.

Returns:

the Handler.

getCheckBox

public LegacyTristateCheckBox getCheckBox()

Deprecated.

Get the CheckBox used for CheckBoxTreeCellRenderer.

Returns:

the check box.

See Also:

setCheckBox(LegacyTristateCheckBox)

setCheckBox

public void setCheckBox(LegacyTristateCheckBox checkBox)

Deprecated.

Set the CheckBox used for CheckBoxTreeCellRenderer.

By default, it's null. CheckBoxTreeCellRenderer then will create a default TristateCheckBox.

Parameters:

checkBox - the check box

isSelectPartialOnToggling

public boolean isSelectPartialOnToggling()

Deprecated.

Gets the flag indicating if toggling should select or deselect the partially selected node.

Returns:

true if select first. Otherwise false.

See Also:

setSelectPartialOnToggling(boolean)

setSelectPartialOnToggling

public void setSelectPartialOnToggling(boolean selectPartialOnToggling)

Deprecated.

Sets the flag indicating if toggling should select or deselect the partially selected node.

By default, the value is true to keep original behavior.

Parameters:

selectPartialOnToggling - the flag

getNextMatch

public javax.swing.tree.TreePath getNextMatch(java.lang.String prefix,
                                              int startingRow,
                                              javax.swing.text.Position.Bias bias)

Deprecated.

Overrides:

getNextMatch in class javax.swing.JTree

getCheckBoxTreeSelectionModel

public LegacyCheckBoxTreeSelectionModel getCheckBoxTreeSelectionModel()

Deprecated.

Gets the selection model for the check boxes. To retrieve the state of check boxes, you should use this selection model.

Returns:

the selection model for the check boxes.

isCheckBoxEnabled

public boolean isCheckBoxEnabled()

Deprecated.

Gets the value of property checkBoxEnabled. If true, user can click on check boxes on each tree node to select and deselect. If false, user can't click but you as developer can programmatically call API to select/deselect it.

Returns:

the value of property checkBoxEnabled.

setCheckBoxEnabled

public void setCheckBoxEnabled(boolean checkBoxEnabled)

Deprecated.

Sets the value of property checkBoxEnabled.

Parameters:

checkBoxEnabled - true to allow to check the check box. False to disable it which means user can see whether a row is checked or not but they cannot change it.

isCheckBoxEnabled

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

Deprecated.

Checks if check box is enabled. There is no setter for it. The only way is to override this method to return true or false.

However, in digIn mode, user can still select the disabled node by selecting all children nodes of that node. Also if user selects the parent node, the disabled children nodes will be selected too.

Parameters:

path - the tree path.

Returns:

true or false. If false, the check box on the particular tree path will be disabled.

isCheckBoxVisible

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

Deprecated.

Checks if check box is visible. There is no setter for it. The only way is to override this method to return true or false.

Parameters:

path - the tree path.

Returns:

true or false. If false, the check box on the particular tree path will be disabled.

isDigIn

public boolean isDigIn()

Deprecated.

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

Returns:

true or false.

setDigIn

public void setDigIn(boolean digIn)

Deprecated.

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

Parameters:

digIn - the new digIn mode.

isClickInCheckBoxOnly

public boolean isClickInCheckBoxOnly()

Deprecated.

Gets the value of property clickInCheckBoxOnly. If true, user can click on check boxes on each tree node to select and deselect. If false, user can't click but you as developer can programmatically call API to select/deselect it.

Returns:

the value of property clickInCheckBoxOnly.

setClickInCheckBoxOnly

public void setClickInCheckBoxOnly(boolean clickInCheckBoxOnly)

Deprecated.

Sets the value of property clickInCheckBoxOnly.

Parameters:

clickInCheckBoxOnly - true to allow to check the check box. False to disable it which means user can see whether a row is checked or not but they cannot change it.