- java.lang.Object
-
- java.awt.Component
-
- java.awt.Container
-
- javax.swing.JComponent
-
- javax.swing.JTree
-
- All Implemented Interfaces:
- ImageObserver, MenuContainer, Serializable, Accessible, Scrollable
public class JTree extends JComponent implements Scrollable, Accessible
A control that displays a set of hierarchical data as an outline. You can find task-oriented documentation and examples of using trees in How to Use Trees, a section in The Java Tutorial.A specific node in a tree can be identified either by a
TreePath
(an object that encapsulates a node and all of its ancestors), or by its display row, where each row in the display area displays one node. An expanded node is a non-leaf node (as identified byTreeModel.isLeaf(node)
returning false) that will displays its children when all its ancestors are expanded. A collapsed node is one which hides them. A hidden node is one which is under a collapsed ancestor. All of a viewable nodes parents are expanded, but may or may not be displayed. A displayed node is both viewable and in the display area, where it can be seen.The following
JTree
methods use "visible" to mean "displayed":isRootVisible()
setRootVisible()
scrollPathToVisible()
scrollRowToVisible()
getVisibleRowCount()
setVisibleRowCount()
The next group of
JTree
methods use "visible" to mean "viewable" (under an expanded parent):isVisible()
makeVisible()
If you are interested in knowing when the selection changes implement the
TreeSelectionListener
interface and add the instance using the methodaddTreeSelectionListener
.valueChanged
will be invoked when the selection changes, that is if the user clicks twice on the same nodevalueChanged
will only be invoked once.If you are interested in detecting either double-click events or when a user clicks on a node, regardless of whether or not it was selected, we recommend you do the following:
final JTree tree = ...; MouseListener ml = new MouseAdapter() { public void mousePressed(MouseEvent e) { int selRow = tree.getRowForLocation(e.getX(), e.getY()); TreePath selPath = tree.getPathForLocation(e.getX(), e.getY()); if(selRow != -1) { if(e.getClickCount() == 1) { mySingleClick(selRow, selPath); } else if(e.getClickCount() == 2) { myDoubleClick(selRow, selPath); } } } }; tree.addMouseListener(ml);
NOTE: This example obtains both the path and row, but you only need to get the one you're interested in.To use
JTree
to display compound nodes (for example, nodes containing both a graphic icon and text), subclassTreeCellRenderer
and usesetCellRenderer(javax.swing.tree.TreeCellRenderer)
to tell the tree to use it. To edit such nodes, subclassTreeCellEditor
and usesetCellEditor(javax.swing.tree.TreeCellEditor)
.Like all
JComponent
classes, you can useInputMap
andActionMap
to associate anAction
object with aKeyStroke
and execute the action under specified conditions.Warning: Swing is not thread safe. For more information see Swing's Threading Policy.
Warning: Serialized objects of this class will not be compatible with future Swing releases. The current serialization support is appropriate for short term storage or RMI between applications running the same version of Swing. As of 1.4, support for long term storage of all JavaBeansTM has been added to the
java.beans
package. Please seeXMLEncoder
.
-
-
Nested Class Summary
Nested Classes Modifier and Type Class and Description protected class
JTree.AccessibleJTree
This class implements accessibility support for theJTree
class.static class
JTree.DropLocation
A subclass ofTransferHandler.DropLocation
representing a drop location for aJTree
.static class
JTree.DynamicUtilTreeNode
DynamicUtilTreeNode
can wrap vectors/hashtables/arrays/strings and create the appropriate children tree nodes as necessary.protected static class
JTree.EmptySelectionModel
EmptySelectionModel
is aTreeSelectionModel
that does not allow anything to be selected.protected class
JTree.TreeModelHandler
Listens to the model and updates theexpandedState
accordingly when nodes are removed, or changed.protected class
JTree.TreeSelectionRedirector
Handles creating a newTreeSelectionEvent
with theJTree
as the source and passing it off to all the listeners.-
Nested classes/interfaces inherited from class javax.swing.JComponent
JComponent.AccessibleJComponent
-
Nested classes/interfaces inherited from class java.awt.Container
Container.AccessibleAWTContainer
-
Nested classes/interfaces inherited from class java.awt.Component
Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy
-
-
Field Summary
Fields Modifier and Type Field and Description static String
ANCHOR_SELECTION_PATH_PROPERTY
Bound property name for anchor selection path.static String
CELL_EDITOR_PROPERTY
Bound property name forcellEditor
.static String
CELL_RENDERER_PROPERTY
Bound property name forcellRenderer
.protected TreeCellEditor
cellEditor
Editor for the entries.protected TreeCellRenderer
cellRenderer
The cell used to draw nodes.protected boolean
editable
Is the tree editable? Default is false.static String
EDITABLE_PROPERTY
Bound property name foreditable
.static String
EXPANDS_SELECTED_PATHS_PROPERTY
Bound property name for expands selected paths propertystatic String
INVOKES_STOP_CELL_EDITING_PROPERTY
Bound property name formessagesStopCellEditing
.protected boolean
invokesStopCellEditing
If true, when editing is to be stopped by way of selection changing, data in tree changing or other meansstopCellEditing
is invoked, and changes are saved.static String
LARGE_MODEL_PROPERTY
Bound property name forlargeModel
.protected boolean
largeModel
Is this tree a large model? This is a code-optimization setting.static String
LEAD_SELECTION_PATH_PROPERTY
Bound property name forleadSelectionPath
.static String
ROOT_VISIBLE_PROPERTY
Bound property name forrootVisible
.protected boolean
rootVisible
True if the root node is displayed, false if its children are the highest visible nodes.static String
ROW_HEIGHT_PROPERTY
Bound property name forrowHeight
.protected int
rowHeight
Height to use for each display row.static String
SCROLLS_ON_EXPAND_PROPERTY
Bound property name forscrollsOnExpand
.protected boolean
scrollsOnExpand
If true, when a node is expanded, as many of the descendants are scrolled to be visible.static String
SELECTION_MODEL_PROPERTY
Bound property name for selectionModel.protected TreeSelectionModel
selectionModel
Models the set of selected nodes in this tree.protected JTree.TreeSelectionRedirector
selectionRedirector
Creates a new event and passed it off theselectionListeners
.static String
SHOWS_ROOT_HANDLES_PROPERTY
Bound property name forshowsRootHandles
.protected boolean
showsRootHandles
True if handles are displayed at the topmost level of the tree.static String
TOGGLE_CLICK_COUNT_PROPERTY
Bound property name fortoggleClickCount
.protected int
toggleClickCount
Number of mouse clicks before a node is expanded.static String
TREE_MODEL_PROPERTY
Bound property name fortreeModel
.protected TreeModel
treeModel
The model that defines the tree displayed by this object.protected TreeModelListener
treeModelListener
Updates theexpandedState
.static String
VISIBLE_ROW_COUNT_PROPERTY
Bound property name forvisibleRowCount
.protected int
visibleRowCount
Number of rows to make visible at one time.-
Fields inherited from class javax.swing.JComponent
accessibleContext, 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
BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT
-
-
Constructor Summary
Constructors Constructor and Description JTree()
Returns aJTree
with a sample model.JTree(Hashtable<?,?> value)
Returns aJTree
created from aHashtable
which does not display with root.JTree(Object[] value)
Returns aJTree
with each element of the specified array as the child of a new root node which is not displayed.JTree(TreeModel newModel)
Returns an instance ofJTree
which displays the root node -- the tree is created using the specified data model.JTree(TreeNode root)
Returns aJTree
with the specifiedTreeNode
as its root, which displays the root node.JTree(TreeNode root, boolean asksAllowsChildren)
Returns aJTree
with the specifiedTreeNode
as its root, which displays the root node and which decides whether a node is a leaf node in the specified manner.JTree(Vector<?> value)
Returns aJTree
with each element of the specifiedVector
as the child of a new root node which is not displayed.
-
Method Summary
Methods Modifier and Type Method and Description void
addSelectionInterval(int index0, int index1)
Adds the specified rows (inclusive) to the selection.void
addSelectionPath(TreePath path)
Adds the node identified by the specifiedTreePath
to the current selection.void
addSelectionPaths(TreePath[] paths)
Adds each path in the array of paths to the current selection.void
addSelectionRow(int row)
Adds the path at the specified row to the current selection.void
addSelectionRows(int[] rows)
Adds the paths at each of the specified rows to the current selection.void
addTreeExpansionListener(TreeExpansionListener tel)
Adds a listener forTreeExpansion
events.void
addTreeSelectionListener(TreeSelectionListener tsl)
Adds a listener forTreeSelection
events.void
addTreeWillExpandListener(TreeWillExpandListener tel)
Adds a listener forTreeWillExpand
events.void
cancelEditing()
Cancels the current editing session.void
clearSelection()
Clears the selection.protected void
clearToggledPaths()
Clears the cache of toggled tree paths.void
collapsePath(TreePath path)
Ensures that the node identified by the specified path is collapsed and viewable.void
collapseRow(int row)
Ensures that the node in the specified row is collapsed.String
convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
Called by the renderers to convert the specified value to text.protected static TreeModel
createTreeModel(Object value)
Returns aTreeModel
wrapping the specified object.protected TreeModelListener
createTreeModelListener()
Creates and returns an instance ofTreeModelHandler
.void
expandPath(TreePath path)
Ensures that the node identified by the specified path is expanded and viewable.void
expandRow(int row)
Ensures that the node in the specified row is expanded and viewable.void
fireTreeCollapsed(TreePath path)
Notifies all listeners that have registered interest for notification on this event type.void
fireTreeExpanded(TreePath path)
Notifies all listeners that have registered interest for notification on this event type.void
fireTreeWillCollapse(TreePath path)
Notifies all listeners that have registered interest for notification on this event type.void
fireTreeWillExpand(TreePath path)
Notifies all listeners that have registered interest for notification on this event type.protected void
fireValueChanged(TreeSelectionEvent e)
Notifies all listeners that have registered interest for notification on this event type.AccessibleContext
getAccessibleContext()
Gets the AccessibleContext associated with this JTree.TreePath
getAnchorSelectionPath()
Returns the path identified as the anchor.TreeCellEditor
getCellEditor()
Returns the editor used to edit entries in the tree.TreeCellRenderer
getCellRenderer()
Returns the currentTreeCellRenderer
that is rendering each cell.TreePath
getClosestPathForLocation(int x, int y)
Returns the path to the node that is closest to x,y.int
getClosestRowForLocation(int x, int y)
Returns the row to the node that is closest to x,y.protected static TreeModel
getDefaultTreeModel()
Creates and returns a sampleTreeModel
.protected Enumeration<TreePath>
getDescendantToggledPaths(TreePath parent)
Returns anEnumeration
ofTreePaths
that have been expanded that are descendants ofparent
.boolean
getDragEnabled()
Returns whether or not automatic drag handling is enabled.JTree.DropLocation
getDropLocation()
Returns the location that this component should visually indicate as the drop location during a DnD operation over the component, ornull
if no location is to currently be shown.DropMode
getDropMode()
Returns the drop mode for this component.TreePath
getEditingPath()
Returns the path to the element that is currently being edited.Enumeration<TreePath>
getExpandedDescendants(TreePath parent)
Returns anEnumeration
of the descendants of the pathparent
that are currently expanded.boolean
getExpandsSelectedPaths()
Returns theexpandsSelectedPaths
property.boolean
getInvokesStopCellEditing()
Returns the indicator that tells what happens when editing is interrupted.Object
getLastSelectedPathComponent()
Returns the last path component of the selected path.TreePath
getLeadSelectionPath()
Returns the path identified as the lead.int
getLeadSelectionRow()
Returns the row index corresponding to the lead path.int
getMaxSelectionRow()
Returns the largest selected row.int
getMinSelectionRow()
Returns the smallest selected row.TreeModel
getModel()
Returns theTreeModel
that is providing the data.TreePath
getNextMatch(String prefix, int startingRow, Position.Bias bias)
Returns the TreePath to the next tree element that begins with a prefix.protected TreePath[]
getPathBetweenRows(int index0, int index1)
Returns the paths (inclusive) between the specified rows.Rectangle
getPathBounds(TreePath path)
Returns theRectangle
that the specified node will be drawn into.TreePath
getPathForLocation(int x, int y)
Returns the path for the node at the specified location.TreePath
getPathForRow(int row)
Returns the path for the specified row.Dimension
getPreferredScrollableViewportSize()
Returns the preferred display size of aJTree
.Rectangle
getRowBounds(int row)
Returns theRectangle
that the node at the specified row is drawn in.int
getRowCount()
Returns the number of viewable nodes.int
getRowForLocation(int x, int y)
Returns the row for the specified location.int
getRowForPath(TreePath path)
Returns the row that displays the node identified by the specified path.int
getRowHeight()
Returns the height of each row.int
getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Returns the amount for a block increment, which is the height or width ofvisibleRect
, based onorientation
.boolean
getScrollableTracksViewportHeight()
Returns false to indicate that the height of the viewport does not determine the height of the table, unless the preferred height of the tree is smaller than the viewports height.boolean
getScrollableTracksViewportWidth()
Returns false to indicate that the width of the viewport does not determine the width of the table, unless the preferred width of the tree is smaller than the viewports width.int
getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Returns the amount to increment when scrolling.boolean
getScrollsOnExpand()
Returns the value of thescrollsOnExpand
property.int
getSelectionCount()
Returns the number of nodes selected.TreeSelectionModel
getSelectionModel()
Returns the model for selections.TreePath
getSelectionPath()
Returns the path to the first selected node.TreePath[]
getSelectionPaths()
Returns the paths of all selected values.int[]
getSelectionRows()
Returns all of the currently selected rows.boolean
getShowsRootHandles()
Returns the value of theshowsRootHandles
property.int
getToggleClickCount()
Returns the number of mouse clicks needed to expand or close a node.String
getToolTipText(MouseEvent event)
OverridesJComponent
'sgetToolTipText
method in order to allow renderer's tips to be used if it has text set.TreeExpansionListener[]
getTreeExpansionListeners()
Returns an array of all theTreeExpansionListener
s added to this JTree with addTreeExpansionListener().TreeSelectionListener[]
getTreeSelectionListeners()
Returns an array of all theTreeSelectionListener
s added to this JTree with addTreeSelectionListener().TreeWillExpandListener[]
getTreeWillExpandListeners()
Returns an array of all theTreeWillExpandListener
s added to this JTree with addTreeWillExpandListener().TreeUI
getUI()
Returns the L&F object that renders this component.String
getUIClassID()
Returns the name of the L&F class that renders this component.int
getVisibleRowCount()
Returns the number of rows that are displayed in the display area.boolean
hasBeenExpanded(TreePath path)
Returns true if the node identified by the path has ever been expanded.boolean
isCollapsed(int row)
Returns true if the node at the specified display row is collapsed.boolean
isCollapsed(TreePath path)
Returns true if the value identified by path is currently collapsed, this will return false if any of the values in path are currently not being displayed.boolean
isEditable()
Returns true if the tree is editable.boolean
isEditing()
Returns true if the tree is being edited.boolean
isExpanded(int row)
Returns true if the node at the specified display row is currently expanded.boolean
isExpanded(TreePath path)
Returns true if the node identified by the path is currently expanded,boolean
isFixedRowHeight()
Returns true if the height of each display row is a fixed size.boolean
isLargeModel()
Returns true if the tree is configured for a large model.boolean
isPathEditable(TreePath path)
ReturnsisEditable
.boolean
isPathSelected(TreePath path)
Returns true if the item identified by the path is currently selected.boolean
isRootVisible()
Returns true if the root node of the tree is displayed.boolean
isRowSelected(int row)
Returns true if the node identified by row is selected.boolean
isSelectionEmpty()
Returns true if the selection is currently empty.boolean
isVisible(TreePath path)
Returns true if the value identified by path is currently viewable, which means it is either the root or all of its parents are expanded.void
makeVisible(TreePath path)
Ensures that the node identified by path is currently viewable.protected String
paramString()
Returns a string representation of thisJTree
.protected boolean
removeDescendantSelectedPaths(TreePath path, boolean includePath)
Removes any paths in the selection that are descendants ofpath
.protected void
removeDescendantToggledPaths(Enumeration<TreePath> toRemove)
Removes any descendants of theTreePaths
intoRemove
that have been expanded.void
removeSelectionInterval(int index0, int index1)
Removes the specified rows (inclusive) from the selection.void
removeSelectionPath(TreePath path)
Removes the node identified by the specified path from the current selection.void
removeSelectionPaths(TreePath[] paths)
Removes the nodes identified by the specified paths from the current selection.void
removeSelectionRow(int row)
Removes the row at the indexrow
from the current selection.void
removeSelectionRows(int[] rows)
Removes the rows that are selected at each of the specified rows.void
removeTreeExpansionListener(TreeExpansionListener tel)
Removes a listener forTreeExpansion
events.void
removeTreeSelectionListener(TreeSelectionListener tsl)
Removes aTreeSelection
listener.void
removeTreeWillExpandListener(TreeWillExpandListener tel)
Removes a listener forTreeWillExpand
events.void
scrollPathToVisible(TreePath path)
Makes sure all the path components in path are expanded (except for the last path component) and scrolls so that the node identified by the path is displayed.void
scrollRowToVisible(int row)
Scrolls the item identified by row until it is displayed.void
setAnchorSelectionPath(TreePath newPath)
Sets the path identified as the anchor.void
setCellEditor(TreeCellEditor cellEditor)
Sets the cell editor.void
setCellRenderer(TreeCellRenderer x)
Sets theTreeCellRenderer
that will be used to draw each cell.void
setDragEnabled(boolean b)
Turns on or off automatic drag handling.void
setDropMode(DropMode dropMode)
Sets the drop mode for this component.void
setEditable(boolean flag)
Determines whether the tree is editable.protected void
setExpandedState(TreePath path, boolean state)
Sets the expanded state of thisJTree
.void
setExpandsSelectedPaths(boolean newValue)
Configures theexpandsSelectedPaths
property.void
setInvokesStopCellEditing(boolean newValue)
Determines what happens when editing is interrupted by selecting another node in the tree, a change in the tree's data, or by some other means.void
setLargeModel(boolean newValue)
Specifies whether the UI should use a large model.void
setLeadSelectionPath(TreePath newPath)
Sets the path identifies as the lead.void
setModel(TreeModel newModel)
Sets theTreeModel
that will provide the data.void
setRootVisible(boolean rootVisible)
Determines whether or not the root node from theTreeModel
is visible.void
setRowHeight(int rowHeight)
Sets the height of each cell, in pixels.void
setScrollsOnExpand(boolean newValue)
Sets thescrollsOnExpand
property, which determines whether the tree might scroll to show previously hidden children.void
setSelectionInterval(int index0, int index1)
Selects the rows in the specified interval (inclusive).void
setSelectionModel(TreeSelectionModel selectionModel)
Sets the tree's selection model.void
setSelectionPath(TreePath path)
Selects the node identified by the specified path.void
setSelectionPaths(TreePath[] paths)
Selects the nodes identified by the specified array of paths.void
setSelectionRow(int row)
Selects the node at the specified row in the display.void
setSelectionRows(int[] rows)
Selects the nodes corresponding to each of the specified rows in the display.void
setShowsRootHandles(boolean newValue)
Sets the value of theshowsRootHandles
property, which specifies whether the node handles should be displayed.void
setToggleClickCount(int clickCount)
Sets the number of mouse clicks before a node will expand or close.void
setUI(TreeUI ui)
Sets the L&F object that renders this component.void
setVisibleRowCount(int newCount)
Sets the number of rows that are to be displayed.void
startEditingAtPath(TreePath path)
Selects the node identified by the specified path and initiates editing.boolean
stopEditing()
Ends the current editing session.void
treeDidChange()
Sent when the tree has changed enough that we need to resize the bounds, but not enough that we need to remove the expanded node set (e.g nodes were expanded or collapsed, or nodes were inserted into the tree).void
updateUI()
Notification from theUIManager
that the L&F has changed.-
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
-
-
-
-
Field Detail
-
treeModel
protected transient TreeModel treeModel
The model that defines the tree displayed by this object.
-
selectionModel
protected transient TreeSelectionModel selectionModel
Models the set of selected nodes in this tree.
-
rootVisible
protected boolean rootVisible
True if the root node is displayed, false if its children are the highest visible nodes.
-
cellRenderer
protected transient TreeCellRenderer cellRenderer
The cell used to draw nodes. Ifnull
, the UI uses a defaultcellRenderer
.
-
rowHeight
protected int rowHeight
Height to use for each display row. If this is <= 0 the renderer determines the height for each row.
-
showsRootHandles
protected boolean showsRootHandles
True if handles are displayed at the topmost level of the tree.A handle is a small icon that displays adjacent to the node which allows the user to click once to expand or collapse the node. A common interface shows a plus sign (+) for a node which can be expanded and a minus sign (-) for a node which can be collapsed. Handles are always shown for nodes below the topmost level.
If the
rootVisible
setting specifies that the root node is to be displayed, then that is the only node at the topmost level. If the root node is not displayed, then all of its children are at the topmost level of the tree. Handles are always displayed for nodes other than the topmost.If the root node isn't visible, it is generally a good to make this value true. Otherwise, the tree looks exactly like a list, and users may not know that the "list entries" are actually tree nodes.
- See Also:
rootVisible
-
selectionRedirector
protected transient JTree.TreeSelectionRedirector selectionRedirector
Creates a new event and passed it off theselectionListeners
.
-
cellEditor
protected transient TreeCellEditor cellEditor
Editor for the entries. Default isnull
(tree is not editable).
-
editable
protected boolean editable
Is the tree editable? Default is false.
-
largeModel
protected boolean largeModel
Is this tree a large model? This is a code-optimization setting. A large model can be used when the cell height is the same for all nodes. The UI will then cache very little information and instead continually message the model. Without a large model the UI caches most of the information, resulting in fewer method calls to the model.This value is only a suggestion to the UI. Not all UIs will take advantage of it. Default value is false.
-
visibleRowCount
protected int visibleRowCount
Number of rows to make visible at one time. This value is used for theScrollable
interface. It determines the preferred size of the display area.
-
invokesStopCellEditing
protected boolean invokesStopCellEditing
If true, when editing is to be stopped by way of selection changing, data in tree changing or other meansstopCellEditing
is invoked, and changes are saved. If false,cancelCellEditing
is invoked, and changes are discarded. Default is false.
-
scrollsOnExpand
protected boolean scrollsOnExpand
If true, when a node is expanded, as many of the descendants are scrolled to be visible.
-
toggleClickCount
protected int toggleClickCount
Number of mouse clicks before a node is expanded.
-
treeModelListener
protected transient TreeModelListener treeModelListener
Updates theexpandedState
.
-
CELL_RENDERER_PROPERTY
public static final String CELL_RENDERER_PROPERTY
Bound property name forcellRenderer
.- See Also:
- Constant Field Values
-
TREE_MODEL_PROPERTY
public static final String TREE_MODEL_PROPERTY
Bound property name fortreeModel
.- See Also:
- Constant Field Values
-
ROOT_VISIBLE_PROPERTY
public static final String ROOT_VISIBLE_PROPERTY
Bound property name forrootVisible
.- See Also:
- Constant Field Values
-
SHOWS_ROOT_HANDLES_PROPERTY
public static final String SHOWS_ROOT_HANDLES_PROPERTY
Bound property name forshowsRootHandles
.- See Also:
- Constant Field Values
-
ROW_HEIGHT_PROPERTY
public static final String ROW_HEIGHT_PROPERTY
Bound property name forrowHeight
.- See Also:
- Constant Field Values
-
CELL_EDITOR_PROPERTY
public static final String CELL_EDITOR_PROPERTY
Bound property name forcellEditor
.- See Also:
- Constant Field Values
-
EDITABLE_PROPERTY
public static final String EDITABLE_PROPERTY
Bound property name foreditable
.- See Also:
- Constant Field Values
-
LARGE_MODEL_PROPERTY
public static final String LARGE_MODEL_PROPERTY
Bound property name forlargeModel
.- See Also:
- Constant Field Values
-
SELECTION_MODEL_PROPERTY
public static final String SELECTION_MODEL_PROPERTY
Bound property name for selectionModel.- See Also:
- Constant Field Values
-
VISIBLE_ROW_COUNT_PROPERTY
public static final String VISIBLE_ROW_COUNT_PROPERTY
Bound property name forvisibleRowCount
.- See Also:
- Constant Field Values
-
INVOKES_STOP_CELL_EDITING_PROPERTY
public static final String INVOKES_STOP_CELL_EDITING_PROPERTY
Bound property name formessagesStopCellEditing
.- See Also:
- Constant Field Values
-
SCROLLS_ON_EXPAND_PROPERTY
public static final String SCROLLS_ON_EXPAND_PROPERTY
Bound property name forscrollsOnExpand
.- See Also:
- Constant Field Values
-
TOGGLE_CLICK_COUNT_PROPERTY
public static final String TOGGLE_CLICK_COUNT_PROPERTY
Bound property name fortoggleClickCount
.- See Also:
- Constant Field Values
-
LEAD_SELECTION_PATH_PROPERTY
public static final String LEAD_SELECTION_PATH_PROPERTY
Bound property name forleadSelectionPath
.- Since:
- 1.3
- See Also:
- Constant Field Values
-
ANCHOR_SELECTION_PATH_PROPERTY
public static final String ANCHOR_SELECTION_PATH_PROPERTY
Bound property name for anchor selection path.- Since:
- 1.3
- See Also:
- Constant Field Values
-
EXPANDS_SELECTED_PATHS_PROPERTY
public static final String EXPANDS_SELECTED_PATHS_PROPERTY
Bound property name for expands selected paths property- Since:
- 1.3
- See Also:
- Constant Field Values
-
-
Constructor Detail
-
JTree
public JTree()
Returns aJTree
with a sample model. The default model used by the tree defines a leaf node as any node without children.- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
public JTree(Object[] value)
Returns aJTree
with each element of the specified array as the child of a new root node which is not displayed. By default, the tree defines a leaf node as any node without children.- Parameters:
value
- an array ofObject
s- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
public JTree(Vector<?> value)
Returns aJTree
with each element of the specifiedVector
as the child of a new root node which is not displayed. By default, the tree defines a leaf node as any node without children.- Parameters:
value
- aVector
- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
public JTree(Hashtable<?,?> value)
Returns aJTree
created from aHashtable
which does not display with root. Each value-half of the key/value pairs in theHashTable
becomes a child of the new root node. By default, the tree defines a leaf node as any node without children.- Parameters:
value
- aHashtable
- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
public JTree(TreeNode root)
Returns aJTree
with the specifiedTreeNode
as its root, which displays the root node. By default, the tree defines a leaf node as any node without children.- Parameters:
root
- aTreeNode
object- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
public JTree(TreeNode root, boolean asksAllowsChildren)
Returns aJTree
with the specifiedTreeNode
as its root, which displays the root node and which decides whether a node is a leaf node in the specified manner.- Parameters:
root
- aTreeNode
objectasksAllowsChildren
- if false, any node without children is a leaf node; if true, only nodes that do not allow children are leaf nodes- See Also:
DefaultTreeModel.asksAllowsChildren
-
JTree
@ConstructorProperties(value="model") public JTree(TreeModel newModel)
Returns an instance ofJTree
which displays the root node -- the tree is created using the specified data model.- Parameters:
newModel
- theTreeModel
to use as the data model
-
-
Method Detail
-
getDefaultTreeModel
protected static TreeModel getDefaultTreeModel()
Creates and returns a sampleTreeModel
. Used primarily for beanbuilders to show something interesting.- Returns:
- the default
TreeModel
-
createTreeModel
protected static TreeModel createTreeModel(Object value)
Returns aTreeModel
wrapping the specified object. If the object is:- an array of
Object
s, - a
Hashtable
, or - a
Vector
"root"
.- Parameters:
value
- theObject
used as the foundation for theTreeModel
- Returns:
- a
TreeModel
wrapping the specified object
- an array of
-
getUI
public TreeUI getUI()
Returns the L&F object that renders this component.- Returns:
- the
TreeUI
object that renders this component
-
setUI
public void setUI(TreeUI ui)
Sets the L&F object that renders this component.This is a bound property.
- Parameters:
ui
- theTreeUI
L&F object- See Also:
UIDefaults.getUI(javax.swing.JComponent)
-
updateUI
public void updateUI()
Notification from theUIManager
that the L&F has changed. Replaces the current UI object with the latest version from theUIManager
.- Overrides:
updateUI
in classJComponent
- See Also:
JComponent.updateUI()
-
getUIClassID
public String getUIClassID()
Returns the name of the L&F class that renders this component.- Overrides:
getUIClassID
in classJComponent
- Returns:
- the string "TreeUI"
- See Also:
JComponent.getUIClassID()
,UIDefaults.getUI(javax.swing.JComponent)
-
getCellRenderer
public TreeCellRenderer getCellRenderer()
Returns the currentTreeCellRenderer
that is rendering each cell.- Returns:
- the
TreeCellRenderer
that is rendering each cell
-
setCellRenderer
public void setCellRenderer(TreeCellRenderer x)
Sets theTreeCellRenderer
that will be used to draw each cell.This is a bound property.
- Parameters:
x
- theTreeCellRenderer
that is to render each cell
-
setEditable
public void setEditable(boolean flag)
Determines whether the tree is editable. Fires a property change event if the new setting is different from the existing setting.This is a bound property.
- Parameters:
flag
- a boolean value, true if the tree is editable
-
isEditable
public boolean isEditable()
Returns true if the tree is editable.- Returns:
- true if the tree is editable
-
setCellEditor
public void setCellEditor(TreeCellEditor cellEditor)
Sets the cell editor. Anull
value implies that the tree cannot be edited. If this represents a change in thecellEditor
, thepropertyChange
method is invoked on all listeners.This is a bound property.
- Parameters:
cellEditor
- theTreeCellEditor
to use
-
getCellEditor
public TreeCellEditor getCellEditor()
Returns the editor used to edit entries in the tree.- Returns:
- the
TreeCellEditor
in use, ornull
if the tree cannot be edited
-
getModel
public TreeModel getModel()
Returns theTreeModel
that is providing the data.- Returns:
- the
TreeModel
that is providing the data
-
setModel
public void setModel(TreeModel newModel)
Sets theTreeModel
that will provide the data.This is a bound property.
- Parameters:
newModel
- theTreeModel
that is to provide the data
-
isRootVisible
public boolean isRootVisible()
Returns true if the root node of the tree is displayed.- Returns:
- true if the root node of the tree is displayed
- See Also:
rootVisible
-
setRootVisible
public void setRootVisible(boolean rootVisible)
Determines whether or not the root node from theTreeModel
is visible.This is a bound property.
- Parameters:
rootVisible
- true if the root node of the tree is to be displayed- See Also:
rootVisible
-
setShowsRootHandles
public void setShowsRootHandles(boolean newValue)
Sets the value of theshowsRootHandles
property, which specifies whether the node handles should be displayed. The default value of this property depends on the constructor used to create theJTree
. Some look and feels might not support handles; they will ignore this property.This is a bound property.
- Parameters:
newValue
-true
if root handles should be displayed; otherwise,false
- See Also:
showsRootHandles
,getShowsRootHandles()
-
getShowsRootHandles
public boolean getShowsRootHandles()
Returns the value of theshowsRootHandles
property.- Returns:
- the value of the
showsRootHandles
property - See Also:
showsRootHandles
-
setRowHeight
public void setRowHeight(int rowHeight)
Sets the height of each cell, in pixels. If the specified value is less than or equal to zero the current cell renderer is queried for each row's height.This is a bound property.
- Parameters:
rowHeight
- the height of each cell, in pixels
-
getRowHeight
public int getRowHeight()
Returns the height of each row. If the returned value is less than or equal to 0 the height for each row is determined by the renderer.
-
isFixedRowHeight
public boolean isFixedRowHeight()
Returns true if the height of each display row is a fixed size.- Returns:
- true if the height of each row is a fixed size
-
setLargeModel
public void setLargeModel(boolean newValue)
Specifies whether the UI should use a large model. (Not all UIs will implement this.) Fires a property change for the LARGE_MODEL_PROPERTY.This is a bound property.
- Parameters:
newValue
- true to suggest a large model to the UI- See Also:
largeModel
-
isLargeModel
public boolean isLargeModel()
Returns true if the tree is configured for a large model.- Returns:
- true if a large model is suggested
- See Also:
largeModel
-
setInvokesStopCellEditing
public void setInvokesStopCellEditing(boolean newValue)
Determines what happens when editing is interrupted by selecting another node in the tree, a change in the tree's data, or by some other means. Setting this property totrue
causes the changes to be automatically saved when editing is interrupted.Fires a property change for the INVOKES_STOP_CELL_EDITING_PROPERTY.
- Parameters:
newValue
- true means thatstopCellEditing
is invoked when editing is interrupted, and data is saved; false means thatcancelCellEditing
is invoked, and changes are lost
-
getInvokesStopCellEditing
public boolean getInvokesStopCellEditing()
Returns the indicator that tells what happens when editing is interrupted.- Returns:
- the indicator that tells what happens when editing is interrupted
- See Also:
setInvokesStopCellEditing(boolean)
-
setScrollsOnExpand
public void setScrollsOnExpand(boolean newValue)
Sets thescrollsOnExpand
property, which determines whether the tree might scroll to show previously hidden children. If this property istrue
(the default), when a node expands the tree can use scrolling to make the maximum possible number of the node's descendants visible. In some look and feels, trees might not need to scroll when expanded; those look and feels will ignore this property.This is a bound property.
- Parameters:
newValue
-false
to disable scrolling on expansion;true
to enable it- See Also:
getScrollsOnExpand()
-
getScrollsOnExpand
public boolean getScrollsOnExpand()
Returns the value of thescrollsOnExpand
property.- Returns:
- the value of the
scrollsOnExpand
property
-
setToggleClickCount
public void setToggleClickCount(int clickCount)
Sets the number of mouse clicks before a node will expand or close. The default is two.This is a bound property.
- Since:
- 1.3
-
getToggleClickCount
public int getToggleClickCount()
Returns the number of mouse clicks needed to expand or close a node.- Returns:
- number of mouse clicks before node is expanded
- Since:
- 1.3
-
setExpandsSelectedPaths
public void setExpandsSelectedPaths(boolean newValue)
Configures theexpandsSelectedPaths
property. If true, any time the selection is changed, either via theTreeSelectionModel
, or the cover methods provided byJTree
, theTreePath
s parents will be expanded to make them visible (visible meaning the parent path is expanded, not necessarily in the visible rectangle of theJTree
). If false, when the selection changes the nodes parent is not made visible (all its parents expanded). This is useful if you wish to have your selection model maintain paths that are not always visible (all parents expanded).This is a bound property.
- Parameters:
newValue
- the new value forexpandsSelectedPaths
- Since:
- 1.3
-
getExpandsSelectedPaths
public boolean getExpandsSelectedPaths()
Returns theexpandsSelectedPaths
property.- Returns:
- true if selection changes result in the parent path being expanded
- Since:
- 1.3
- See Also:
setExpandsSelectedPaths(boolean)
-
setDragEnabled
public void setDragEnabled(boolean b)
Turns on or off automatic drag handling. In order to enable automatic drag handling, this property should be set totrue
, and the tree'sTransferHandler
needs to benon-null
. The default value of thedragEnabled
property isfalse
.The job of honoring this property, and recognizing a user drag gesture, lies with the look and feel implementation, and in particular, the tree's
TreeUI
. When automatic drag handling is enabled, most look and feels (including those that subclassBasicLookAndFeel
) begin a drag and drop operation whenever the user presses the mouse button over an item and then moves the mouse a few pixels. Setting this property totrue
can therefore have a subtle effect on how selections behave.If a look and feel is used that ignores this property, you can still begin a drag and drop operation by calling
exportAsDrag
on the tree'sTransferHandler
.- Parameters:
b
- whether or not to enable automatic drag handling- Throws:
HeadlessException
- ifb
istrue
andGraphicsEnvironment.isHeadless()
returnstrue
- Since:
- 1.4
- See Also:
GraphicsEnvironment.isHeadless()
,getDragEnabled()
,JComponent.setTransferHandler(javax.swing.TransferHandler)
,TransferHandler
-
getDragEnabled
public boolean getDragEnabled()
Returns whether or not automatic drag handling is enabled.- Returns:
- the value of the
dragEnabled
property - Since:
- 1.4
- See Also:
setDragEnabled(boolean)
-
setDropMode
public final void setDropMode(DropMode dropMode)
Sets the drop mode for this component. For backward compatibility, the default for this property isDropMode.USE_SELECTION
. Usage of one of the other modes is recommended, however, for an improved user experience.DropMode.ON
, for instance, offers similar behavior of showing items as selected, but does so without affecting the actual selection in the tree.JTree
supports the following drop modes:DropMode.USE_SELECTION
DropMode.ON
DropMode.INSERT
DropMode.ON_OR_INSERT
The drop mode is only meaningful if this component has a
TransferHandler
that accepts drops.- Parameters:
dropMode
- the drop mode to use- Throws:
IllegalArgumentException
- if the drop mode is unsupported ornull
- Since:
- 1.6
- See Also:
getDropMode()
,getDropLocation()
,JComponent.setTransferHandler(javax.swing.TransferHandler)
,TransferHandler
-
getDropMode
public final DropMode getDropMode()
Returns the drop mode for this component.- Returns:
- the drop mode for this component
- Since:
- 1.6
- See Also:
setDropMode(javax.swing.DropMode)
-
getDropLocation
public final JTree.DropLocation getDropLocation()
Returns the location that this component should visually indicate as the drop location during a DnD operation over the component, ornull
if no location is to currently be shown.This method is not meant for querying the drop location from a
TransferHandler
, as the drop location is only set after theTransferHandler
'scanImport
has returned and has allowed for the location to be shown.When this property changes, a property change event with name "dropLocation" is fired by the component.
- Returns:
- the drop location
- Since:
- 1.6
- See Also:
setDropMode(javax.swing.DropMode)
,TransferHandler.canImport(TransferHandler.TransferSupport)
-
isPathEditable
public boolean isPathEditable(TreePath path)
ReturnsisEditable
. This is invoked from the UI before editing begins to insure that the given path can be edited. This is provided as an entry point for subclassers to add filtered editing without having to resort to creating a new editor.- Returns:
- true if every parent node and the node itself is editable
- See Also:
isEditable()
-
getToolTipText
public String getToolTipText(MouseEvent event)
OverridesJComponent
'sgetToolTipText
method in order to allow renderer's tips to be used if it has text set.NOTE: For
JTree
to properly display tooltips of its renderers,JTree
must be a registered component with theToolTipManager
. This can be done by invokingToolTipManager.sharedInstance().registerComponent(tree)
. This is not done automatically!- Overrides:
getToolTipText
in classJComponent
- Parameters:
event
- theMouseEvent
that initiated theToolTip
display- Returns:
- a string containing the tooltip or
null
ifevent
is null
-
convertValueToText
public String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)
Called by the renderers to convert the specified value to text. This implementation returnsvalue.toString
, ignoring all other arguments. To control the conversion, subclass this method and use any of the arguments you need.- Parameters:
value
- theObject
to convert to textselected
- true if the node is selectedexpanded
- true if the node is expandedleaf
- true if the node is a leaf noderow
- an integer specifying the node's display row, where 0 is the first row in the displayhasFocus
- true if the node has the focus- Returns:
- the
String
representation of the node's value
-
getRowCount
public int getRowCount()
Returns the number of viewable nodes. A node is viewable if all of its parents are expanded. The root is only included in this count ifisRootVisible()
istrue
. This returns0
if the UI has not been set.- Returns:
- the number of viewable nodes
-
setSelectionPath
public void setSelectionPath(TreePath path)
Selects the node identified by the specified path. If any component of the path is hidden (under a collapsed node), andgetExpandsSelectedPaths
is true it is exposed (made viewable).- Parameters:
path
- theTreePath
specifying the node to select
-
setSelectionPaths
public void setSelectionPaths(TreePath[] paths)
Selects the nodes identified by the specified array of paths. If any component in any of the paths is hidden (under a collapsed node), andgetExpandsSelectedPaths
is true it is exposed (made viewable).- Parameters:
paths
- an array ofTreePath
objects that specifies the nodes to select
-
setLeadSelectionPath
public void setLeadSelectionPath(TreePath newPath)
Sets the path identifies as the lead. The lead may not be selected. The lead is not maintained byJTree
, rather the UI will update it.This is a bound property.
- Parameters:
newPath
- the new lead path- Since:
- 1.3
-
setAnchorSelectionPath
public void setAnchorSelectionPath(TreePath newPath)
Sets the path identified as the anchor. The anchor is not maintained byJTree
, rather the UI will update it.This is a bound property.
- Parameters:
newPath
- the new anchor path- Since:
- 1.3
-
setSelectionRow
public void setSelectionRow(int row)
Selects the node at the specified row in the display.- Parameters:
row
- the row to select, where 0 is the first row in the display
-
setSelectionRows
public void setSelectionRows(int[] rows)
Selects the nodes corresponding to each of the specified rows in the display. If a particular element ofrows
is < 0 or >=getRowCount
, it will be ignored. If none of the elements inrows
are valid rows, the selection will be cleared. That is it will be as ifclearSelection
was invoked.- Parameters:
rows
- an array of ints specifying the rows to select, where 0 indicates the first row in the display
-
addSelectionPath
public void addSelectionPath(TreePath path)
Adds the node identified by the specifiedTreePath
to the current selection. If any component of the path isn't viewable, andgetExpandsSelectedPaths
is true it is made viewable.Note that
JTree
does not allow duplicate nodes to exist as children under the same parent -- each sibling must be a unique object.- Parameters:
path
- theTreePath
to add
-
addSelectionPaths
public void addSelectionPaths(TreePath[] paths)
Adds each path in the array of paths to the current selection. If any component of any of the paths isn't viewable andgetExpandsSelectedPaths
is true, it is made viewable.Note that
JTree
does not allow duplicate nodes to exist as children under the same parent -- each sibling must be a unique object.- Parameters:
paths
- an array ofTreePath
objects that specifies the nodes to add
-
addSelectionRow
public void addSelectionRow(int row)
Adds the path at the specified row to the current selection.- Parameters:
row
- an integer specifying the row of the node to add, where 0 is the first row in the display
-
addSelectionRows
public void addSelectionRows(int[] rows)
Adds the paths at each of the specified rows to the current selection.- Parameters:
rows
- an array of ints specifying the rows to add, where 0 indicates the first row in the display
-
getLastSelectedPathComponent
public Object getLastSelectedPathComponent()
Returns the last path component of the selected path. This is a convenience method forgetSelectionModel().getSelectionPath().getLastPathComponent()
. This is typically only useful if the selection has one path.- Returns:
- the last path component of the selected path, or
null
if nothing is selected - See Also:
TreePath.getLastPathComponent()
-
getLeadSelectionPath
public TreePath getLeadSelectionPath()
Returns the path identified as the lead.- Returns:
- path identified as the lead
-
getAnchorSelectionPath
public TreePath getAnchorSelectionPath()
Returns the path identified as the anchor.- Returns:
- path identified as the anchor
- Since:
- 1.3
-
getSelectionPath
public TreePath getSelectionPath()
Returns the path to the first selected node.- Returns:
- the
TreePath
for the first selected node, ornull
if nothing is currently selected
-
getSelectionPaths
public TreePath[] getSelectionPaths()
Returns the paths of all selected values.- Returns:
- an array of
TreePath
objects indicating the selected nodes, ornull
if nothing is currently selected
-
getSelectionRows
public int[] getSelectionRows()
Returns all of the currently selected rows. This method is simply forwarded to theTreeSelectionModel
. If nothing is selectednull
or an empty array will be returned, based on theTreeSelectionModel
implementation.- Returns:
- an array of integers that identifies all currently selected rows where 0 is the first row in the display
-
getSelectionCount
public int getSelectionCount()
Returns the number of nodes selected.- Returns:
- the number of nodes selected
-
getMinSelectionRow
public int getMinSelectionRow()
Returns the smallest selected row. If the selection is empty, or none of the selected paths are viewable,-1
is returned.- Returns:
- the smallest selected row
-
getMaxSelectionRow
public int getMaxSelectionRow()
Returns the largest selected row. If the selection is empty, or none of the selected paths are viewable,-1
is returned.- Returns:
- the largest selected row
-
getLeadSelectionRow
public int getLeadSelectionRow()
Returns the row index corresponding to the lead path.- Returns:
- an integer giving the row index of the lead path,
where 0 is the first row in the display; or -1
if
leadPath
isnull
-
isPathSelected
public boolean isPathSelected(TreePath path)
Returns true if the item identified by the path is currently selected.- Parameters:
path
- aTreePath
identifying a node- Returns:
- true if the node is selected
-
isRowSelected
public boolean isRowSelected(int row)
Returns true if the node identified by row is selected.- Parameters:
row
- an integer specifying a display row, where 0 is the first row in the display- Returns:
- true if the node is selected
-
getExpandedDescendants
public Enumeration<TreePath> getExpandedDescendants(TreePath parent)
Returns anEnumeration
of the descendants of the pathparent
that are currently expanded. Ifparent
is not currently expanded, this will returnnull
. If you expand/collapse nodes while iterating over the returnedEnumeration
this may not return all the expanded paths, or may return paths that are no longer expanded.- Parameters:
parent
- the path which is to be examined- Returns:
- an
Enumeration
of the descendents ofparent
, ornull
ifparent
is not currently expanded
-
hasBeenExpanded
public boolean hasBeenExpanded(TreePath path)
Returns true if the node identified by the path has ever been expanded.- Returns:
- true if the
path
has ever been expanded
-
isExpanded
public boolean isExpanded(TreePath path)
Returns true if the node identified by the path is currently expanded,- Parameters:
path
- theTreePath
specifying the node to check- Returns:
- false if any of the nodes in the node's path are collapsed, true if all nodes in the path are expanded
-
isExpanded
public boolean isExpanded(int row)
Returns true if the node at the specified display row is currently expanded.- Parameters:
row
- the row to check, where 0 is the first row in the display- Returns:
- true if the node is currently expanded, otherwise false
-
isCollapsed
public boolean isCollapsed(TreePath path)
Returns true if the value identified by path is currently collapsed, this will return false if any of the values in path are currently not being displayed.- Parameters:
path
- theTreePath
to check- Returns:
- true if any of the nodes in the node's path are collapsed, false if all nodes in the path are expanded
-
isCollapsed
public boolean isCollapsed(int row)
Returns true if the node at the specified display row is collapsed.- Parameters:
row
- the row to check, where 0 is the first row in the display- Returns:
- true if the node is currently collapsed, otherwise false
-
makeVisible
public void makeVisible(TreePath path)
Ensures that the node identified by path is currently viewable.- Parameters:
path
- theTreePath
to make visible
-
isVisible
public boolean isVisible(TreePath path)
Returns true if the value identified by path is currently viewable, which means it is either the root or all of its parents are expanded. Otherwise, this method returns false.- Returns:
- true if the node is viewable, otherwise false
-
getPathBounds
public Rectangle getPathBounds(TreePath path)
Returns theRectangle
that the specified node will be drawn into. Returnsnull
if any component in the path is hidden (under a collapsed parent).Note:
This method returns a valid rectangle, even if the specified node is not currently displayed.- Parameters:
path
- theTreePath
identifying the node- Returns:
- the
Rectangle
the node is drawn in, ornull
-
getRowBounds
public Rectangle getRowBounds(int row)
Returns theRectangle
that the node at the specified row is drawn in.- Parameters:
row
- the row to be drawn, where 0 is the first row in the display- Returns:
- the
Rectangle
the node is drawn in
-
scrollPathToVisible
public void scrollPathToVisible(TreePath path)
Makes sure all the path components in path are expanded (except for the last path component) and scrolls so that the node identified by the path is displayed. Only works when thisJTree
is contained in aJScrollPane
.- Parameters:
path
- theTreePath
identifying the node to bring into view
-
scrollRowToVisible
public void scrollRowToVisible(int row)
Scrolls the item identified by row until it is displayed. The minimum of amount of scrolling necessary to bring the row into view is performed. Only works when thisJTree
is contained in aJScrollPane
.- Parameters:
row
- an integer specifying the row to scroll, where 0 is the first row in the display
-
getPathForRow
public TreePath getPathForRow(int row)
Returns the path for the specified row. Ifrow
is not visible, or aTreeUI
has not been set,null
is returned.- Parameters:
row
- an integer specifying a row- Returns:
- the
TreePath
to the specified node,null
ifrow < 0
orrow >= getRowCount()
-
getRowForPath
public int getRowForPath(TreePath path)
Returns the row that displays the node identified by the specified path.- Parameters:
path
- theTreePath
identifying a node- Returns:
- an integer specifying the display row, where 0 is the first row in the display, or -1 if any of the elements in path are hidden under a collapsed parent.
-
expandPath
public void expandPath(TreePath path)
Ensures that the node identified by the specified path is expanded and viewable. If the last item in the path is a leaf, this will have no effect.- Parameters:
path
- theTreePath
identifying a node
-
expandRow
public void expandRow(int row)
Ensures that the node in the specified row is expanded and viewable.If
row
is < 0 or >=getRowCount
this will have no effect.- Parameters:
row
- an integer specifying a display row, where 0 is the first row in the display
-
collapsePath
public void collapsePath(TreePath path)
Ensures that the node identified by the specified path is collapsed and viewable.- Parameters:
path
- theTreePath
identifying a node
-
collapseRow
public void collapseRow(int row)
Ensures that the node in the specified row is collapsed.If
row
is < 0 or >=getRowCount
this will have no effect.- Parameters:
row
- an integer specifying a display row, where 0 is the first row in the display
-
getPathForLocation
public TreePath getPathForLocation(int x, int y)
Returns the path for the node at the specified location.- Parameters:
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margin- Returns:
- the
TreePath
for the node at that location
-
getRowForLocation
public int getRowForLocation(int x, int y)
Returns the row for the specified location.- Parameters:
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margin- Returns:
- the row corresponding to the location, or -1 if the location is not within the bounds of a displayed cell
- See Also:
getClosestRowForLocation(int, int)
-
getClosestPathForLocation
public TreePath getClosestPathForLocation(int x, int y)
Returns the path to the node that is closest to x,y. If no nodes are currently viewable, or there is no model, returnsnull
, otherwise it always returns a valid path. To test if the node is exactly at x, y, get the node's bounds and test x, y against that.- Parameters:
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margin- Returns:
- the
TreePath
for the node closest to that location,null
if nothing is viewable or there is no model - See Also:
getPathForLocation(int, int)
,getPathBounds(javax.swing.tree.TreePath)
-
getClosestRowForLocation
public int getClosestRowForLocation(int x, int y)
Returns the row to the node that is closest to x,y. If no nodes are viewable or there is no model, returns -1. Otherwise, it always returns a valid row. To test if the returned object is exactly at x, y, get the bounds for the node at the returned row and test x, y against that.- Parameters:
x
- an integer giving the number of pixels horizontally from the left edge of the display area, minus any left marginy
- an integer giving the number of pixels vertically from the top of the display area, minus any top margin- Returns:
- the row closest to the location, -1 if nothing is viewable or there is no model
- See Also:
getRowForLocation(int, int)
,getRowBounds(int)
-
isEditing
public boolean isEditing()
Returns true if the tree is being edited. The item that is being edited can be obtained usinggetSelectionPath
.- Returns:
- true if the user is currently editing a node
- See Also:
getSelectionPath()
-
stopEditing
public boolean stopEditing()
Ends the current editing session. (TheDefaultTreeCellEditor
object saves any edits that are currently in progress on a cell. Other implementations may operate differently.) Has no effect if the tree isn't being edited.Note:
To make edit-saves automatic whenever the user changes their position in the tree, usesetInvokesStopCellEditing(boolean)
.- Returns:
- true if editing was in progress and is now stopped, false if editing was not in progress
-
cancelEditing
public void cancelEditing()
Cancels the current editing session. Has no effect if the tree isn't being edited.
-
startEditingAtPath
public void startEditingAtPath(TreePath path)
Selects the node identified by the specified path and initiates editing. The edit-attempt fails if theCellEditor
does not allow editing for the specified item.- Parameters:
path
- theTreePath
identifying a node
-
getEditingPath
public TreePath getEditingPath()
Returns the path to the element that is currently being edited.- Returns:
- the
TreePath
for the node being edited
-
setSelectionModel
public void setSelectionModel(TreeSelectionModel selectionModel)
Sets the tree's selection model. When anull
value is specified an emptyselectionModel
is used, which does not allow selections.This is a bound property.
- Parameters:
selectionModel
- theTreeSelectionModel
to use, ornull
to disable selections- See Also:
TreeSelectionModel
-
getSelectionModel
public TreeSelectionModel getSelectionModel()
Returns the model for selections. This should always return a non-null
value. If you don't want to allow anything to be selected set the selection model tonull
, which forces an empty selection model to be used.
-
getPathBetweenRows
protected TreePath[] getPathBetweenRows(int index0, int index1)
Returns the paths (inclusive) between the specified rows. If the specified indices are within the viewable set of rows, or bound the viewable set of rows, then the indices are constrained by the viewable set of rows. If the specified indices are not within the viewable set of rows, or do not bound the viewable set of rows, then an empty array is returned. For example, if the row count is10
, and this method is invoked with-1, 20
, then the specified indices are constrained to the viewable set of rows, and this is treated as if invoked with0, 9
. On the other hand, if this were invoked with-10, -1
, then the specified indices do not bound the viewable set of rows, and an empty array is returned.The parameters are not order dependent. That is,
getPathBetweenRows(x, y)
is equivalent togetPathBetweenRows(y, x)
.An empty array is returned if the row count is
0
, or the specified indices do not bound the viewable set of rows.- Parameters:
index0
- the first index in the rangeindex1
- the last index in the range- Returns:
- the paths (inclusive) between the specified row indices
-
setSelectionInterval
public void setSelectionInterval(int index0, int index1)
Selects the rows in the specified interval (inclusive). If the specified indices are within the viewable set of rows, or bound the viewable set of rows, then the specified rows are constrained by the viewable set of rows. If the specified indices are not within the viewable set of rows, or do not bound the viewable set of rows, then the selection is cleared. For example, if the row count is10
, and this method is invoked with-1, 20
, then the specified indices bounds the viewable range, and this is treated as if invoked with0, 9
. On the other hand, if this were invoked with-10, -1
, then the specified indices do not bound the viewable set of rows, and the selection is cleared.The parameters are not order dependent. That is,
setSelectionInterval(x, y)
is equivalent tosetSelectionInterval(y, x)
.- Parameters:
index0
- the first index in the range to selectindex1
- the last index in the range to select
-
addSelectionInterval
public void addSelectionInterval(int index0, int index1)
Adds the specified rows (inclusive) to the selection. If the specified indices are within the viewable set of rows, or bound the viewable set of rows, then the specified indices are constrained by the viewable set of rows. If the indices are not within the viewable set of rows, or do not bound the viewable set of rows, then the selection is unchanged. For example, if the row count is10
, and this method is invoked with-1, 20
, then the specified indices bounds the viewable range, and this is treated as if invoked with0, 9
. On the other hand, if this were invoked with-10, -1
, then the specified indices do not bound the viewable set of rows, and the selection is unchanged.The parameters are not order dependent. That is,
addSelectionInterval(x, y)
is equivalent toaddSelectionInterval(y, x)
.- Parameters:
index0
- the first index in the range to add to the selectionindex1
- the last index in the range to add to the selection
-
removeSelectionInterval
public void removeSelectionInterval(int index0, int index1)
Removes the specified rows (inclusive) from the selection. If the specified indices are within the viewable set of rows, or bound the viewable set of rows, then the specified indices are constrained by the viewable set of rows. If the specified indices are not within the viewable set of rows, or do not bound the viewable set of rows, then the selection is unchanged. For example, if the row count is10
, and this method is invoked with-1, 20
, then the specified range bounds the viewable range, and this is treated as if invoked with0, 9
. On the other hand, if this were invoked with-10, -1
, then the specified range does not bound the viewable set of rows, and the selection is unchanged.The parameters are not order dependent. That is,
removeSelectionInterval(x, y)
is equivalent toremoveSelectionInterval(y, x)
.- Parameters:
index0
- the first row to remove from the selectionindex1
- the last row to remove from the selection
-
removeSelectionPath
public void removeSelectionPath(TreePath path)
Removes the node identified by the specified path from the current selection.- Parameters:
path
- theTreePath
identifying a node
-
removeSelectionPaths
public void removeSelectionPaths(TreePath[] paths)
Removes the nodes identified by the specified paths from the current selection.- Parameters:
paths
- an array ofTreePath
objects that specifies the nodes to remove
-
removeSelectionRow
public void removeSelectionRow(int row)
Removes the row at the indexrow
from the current selection.- Parameters:
row
- the row to remove
-
removeSelectionRows
public void removeSelectionRows(int[] rows)
Removes the rows that are selected at each of the specified rows.- Parameters:
rows
- an array of ints specifying display rows, where 0 is the first row in the display
-
clearSelection
public void clearSelection()
Clears the selection.
-
isSelectionEmpty
public boolean isSelectionEmpty()
Returns true if the selection is currently empty.- Returns:
- true if the selection is currently empty
-
addTreeExpansionListener
public void addTreeExpansionListener(TreeExpansionListener tel)
Adds a listener forTreeExpansion
events.- Parameters:
tel
- a TreeExpansionListener that will be notified when a tree node is expanded or collapsed (a "negative expansion")
-
removeTreeExpansionListener
public void removeTreeExpansionListener(TreeExpansionListener tel)
Removes a listener forTreeExpansion
events.- Parameters:
tel
- theTreeExpansionListener
to remove
-
getTreeExpansionListeners
public TreeExpansionListener[] getTreeExpansionListeners()
Returns an array of all theTreeExpansionListener
s added to this JTree with addTreeExpansionListener().- Returns:
- all of the
TreeExpansionListener
s added or an empty array if no listeners have been added - Since:
- 1.4
-
addTreeWillExpandListener
public void addTreeWillExpandListener(TreeWillExpandListener tel)
Adds a listener forTreeWillExpand
events.- Parameters:
tel
- aTreeWillExpandListener
that will be notified when a tree node will be expanded or collapsed (a "negative expansion")
-
removeTreeWillExpandListener
public void removeTreeWillExpandListener(TreeWillExpandListener tel)
Removes a listener forTreeWillExpand
events.- Parameters:
tel
- theTreeWillExpandListener
to remove
-
getTreeWillExpandListeners
public TreeWillExpandListener[] getTreeWillExpandListeners()
Returns an array of all theTreeWillExpandListener
s added to this JTree with addTreeWillExpandListener().- Returns:
- all of the
TreeWillExpandListener
s added or an empty array if no listeners have been added - Since:
- 1.4
-
fireTreeExpanded
public void fireTreeExpanded(TreePath path)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using thepath
parameter.- Parameters:
path
- theTreePath
indicating the node that was expanded- See Also:
EventListenerList
-
fireTreeCollapsed
public void fireTreeCollapsed(TreePath path)
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using thepath
parameter.- Parameters:
path
- theTreePath
indicating the node that was collapsed- See Also:
EventListenerList
-
fireTreeWillExpand
public void fireTreeWillExpand(TreePath path) throws ExpandVetoException
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using thepath
parameter.- Parameters:
path
- theTreePath
indicating the node that was expanded- Throws:
ExpandVetoException
- See Also:
EventListenerList
-
fireTreeWillCollapse
public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException
Notifies all listeners that have registered interest for notification on this event type. The event instance is lazily created using thepath
parameter.- Parameters:
path
- theTreePath
indicating the node that was expanded- Throws:
ExpandVetoException
- See Also:
EventListenerList
-
addTreeSelectionListener
public void addTreeSelectionListener(TreeSelectionListener tsl)
Adds a listener forTreeSelection
events.- Parameters:
tsl
- theTreeSelectionListener
that will be notified when a node is selected or deselected (a "negative selection")
-
removeTreeSelectionListener
public void removeTreeSelectionListener(TreeSelectionListener tsl)
Removes aTreeSelection
listener.- Parameters:
tsl
- theTreeSelectionListener
to remove
-
getTreeSelectionListeners
public TreeSelectionListener[] getTreeSelectionListeners()
Returns an array of all theTreeSelectionListener
s added to this JTree with addTreeSelectionListener().- Returns:
- all of the
TreeSelectionListener
s added or an empty array if no listeners have been added - Since:
- 1.4
-
fireValueChanged
protected void fireValueChanged(TreeSelectionEvent e)
Notifies all listeners that have registered interest for notification on this event type.- Parameters:
e
- theTreeSelectionEvent
to be fired; generated by theTreeSelectionModel
when a node is selected or deselected- See Also:
EventListenerList
-
treeDidChange
public void treeDidChange()
Sent when the tree has changed enough that we need to resize the bounds, but not enough that we need to remove the expanded node set (e.g nodes were expanded or collapsed, or nodes were inserted into the tree). You should never have to invoke this, the UI will invoke this as it needs to.
-
setVisibleRowCount
public void setVisibleRowCount(int newCount)
Sets the number of rows that are to be displayed. This will only work if the tree is contained in aJScrollPane
, and will adjust the preferred size and size of that scrollpane.This is a bound property.
- Parameters:
newCount
- the number of rows to display
-
getVisibleRowCount
public int getVisibleRowCount()
Returns the number of rows that are displayed in the display area.- Returns:
- the number of rows displayed
-
getNextMatch
public TreePath getNextMatch(String prefix, int startingRow, Position.Bias bias)
Returns the TreePath to the next tree element that begins with a prefix. To handle the conversion of aTreePath
into a String,convertValueToText
is used.- Parameters:
prefix
- the string to test for a matchstartingRow
- the row for starting the searchbias
- the search direction, either Position.Bias.Forward or Position.Bias.Backward.- Returns:
- the TreePath of the next tree element that starts with the prefix; otherwise null
- Throws:
IllegalArgumentException
- if prefix is null or startingRow is out of bounds- Since:
- 1.4
-
getPreferredScrollableViewportSize
public Dimension getPreferredScrollableViewportSize()
Returns the preferred display size of aJTree
. The height is determined fromgetVisibleRowCount
and the width is the current preferred width.- Specified by:
getPreferredScrollableViewportSize
in interfaceScrollable
- Returns:
- a
Dimension
object containing the preferred size - See Also:
JComponent.getPreferredSize()
-
getScrollableUnitIncrement
public int getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)
Returns the amount to increment when scrolling. The amount is the height of the first displayed row that isn't completely in view or, if it is totally displayed, the height of the next row in the scrolling direction.- Specified by:
getScrollableUnitIncrement
in interfaceScrollable
- Parameters:
visibleRect
- the view area visible within the viewportorientation
- eitherSwingConstants.VERTICAL
orSwingConstants.HORIZONTAL
direction
- less than zero to scroll up/left, greater than zero for down/right- Returns:
- the "unit" increment for scrolling in the specified direction
- See Also:
JScrollBar.setUnitIncrement(int)
-
getScrollableBlockIncrement
public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)
Returns the amount for a block increment, which is the height or width ofvisibleRect
, based onorientation
.- Specified by:
getScrollableBlockIncrement
in interfaceScrollable
- Parameters:
visibleRect
- the view area visible within the viewportorientation
- eitherSwingConstants.VERTICAL
orSwingConstants.HORIZONTAL
direction
- less than zero to scroll up/left, greater than zero for down/right.- Returns:
- the "block" increment for scrolling in the specified direction
- See Also:
JScrollBar.setBlockIncrement(int)
-
getScrollableTracksViewportWidth
public boolean getScrollableTracksViewportWidth()
Returns false to indicate that the width of the viewport does not determine the width of the table, unless the preferred width of the tree is smaller than the viewports width. In other words: ensure that the tree is never smaller than its viewport.- Specified by:
getScrollableTracksViewportWidth
in interfaceScrollable
- Returns:
- whether the tree should track the width of the viewport
- See Also:
Scrollable.getScrollableTracksViewportWidth()
-
getScrollableTracksViewportHeight
public boolean getScrollableTracksViewportHeight()
Returns false to indicate that the height of the viewport does not determine the height of the table, unless the preferred height of the tree is smaller than the viewports height. In other words: ensure that the tree is never smaller than its viewport.- Specified by:
getScrollableTracksViewportHeight
in interfaceScrollable
- Returns:
- whether the tree should track the height of the viewport
- See Also:
Scrollable.getScrollableTracksViewportHeight()
-
setExpandedState
protected void setExpandedState(TreePath path, boolean state)
Sets the expanded state of thisJTree
. Ifstate
is true, all parents ofpath
and path are marked as expanded. Ifstate
is false, all parents ofpath
are marked EXPANDED, butpath
itself is marked collapsed.This will fail if a
TreeWillExpandListener
vetos it.
-
getDescendantToggledPaths
protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)
Returns anEnumeration
ofTreePaths
that have been expanded that are descendants ofparent
.
-
removeDescendantToggledPaths
protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)
Removes any descendants of theTreePaths
intoRemove
that have been expanded.- Parameters:
toRemove
- an enumeration of the paths to remove; a value ofnull
is ignored- Throws:
ClassCastException
- iftoRemove
contains an element that is not aTreePath
;null
values are ignored
-
clearToggledPaths
protected void clearToggledPaths()
Clears the cache of toggled tree paths. This does NOT send out anyTreeExpansionListener
events.
-
createTreeModelListener
protected TreeModelListener createTreeModelListener()
Creates and returns an instance ofTreeModelHandler
. The returned object is responsible for updating the expanded state when theTreeModel
changes.For more information on what expanded state means, see the JTree description above.
-
removeDescendantSelectedPaths
protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)
Removes any paths in the selection that are descendants ofpath
. IfincludePath
is true andpath
is selected, it will be removed from the selection.- Returns:
- true if a descendant was selected
- Since:
- 1.3
-
paramString
protected String paramString()
Returns a string representation of thisJTree
. This method is intended to be used only for debugging purposes, and the content and format of the returned string may vary between implementations. The returned string may be empty but may not benull
.- Overrides:
paramString
in classJComponent
- Returns:
- a string representation of this
JTree
.
-
getAccessibleContext
public AccessibleContext getAccessibleContext()
Gets the AccessibleContext associated with this JTree. For JTrees, the AccessibleContext takes the form of an AccessibleJTree. A new AccessibleJTree instance is created if necessary.- Specified by:
getAccessibleContext
in interfaceAccessible
- Overrides:
getAccessibleContext
in classJComponent
- Returns:
- an AccessibleJTree that serves as the AccessibleContext of this JTree
-
-
Document created the 11/06/2005, last modified the 04/03/2020
Source of the printed document:https://www.gaudry.be/en/java-api-rf-javax/swing/JTree.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.