Class JTree

javax.swing.JTree

All Implemented Interfaces:: ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

@JavaBean(defaultProperty="UI", description="A component that displays a set of hierarchical data as an outline.") 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 by TreeModel.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 method addTreeSelectionListener. valueChanged will be invoked when the selection changes, that is if the user clicks twice on the same node valueChanged 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), subclass TreeCellRenderer and use setCellRenderer(TreeCellRenderer) to tell the tree to use it. To edit such nodes, subclass TreeCellEditor and use setCellEditor(TreeCellEditor).

Like all JComponent classes, you can use InputMap and ActionMap to associate an Action object with a KeyStroke 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 JavaBeans has been added to the java.beans package. Please see XMLEncoder.

Since:: 1.2

Nested Class Summary

Modifier and Type	Class	Description
`protected class`	`JTree.AccessibleJTree`	This class implements accessibility support for the `JTree` class.
`static final class`	`JTree.DropLocation`	A subclass of `TransferHandler.DropLocation` representing a drop location for a `JTree`.
`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 a `TreeSelectionModel` that does not allow anything to be selected.
`protected class`	`JTree.TreeModelHandler`	Listens to the model and updates the `expandedState` accordingly when nodes are removed, or changed.
`protected class`	`JTree.TreeSelectionRedirector`	Handles creating a new `TreeSelectionEvent` with the `JTree` as the source and passing it off to all the listeners.

Nested classes/interfaces declared in class JComponent

JComponent.AccessibleJComponent

Modifier and Type	Class	Description
`class`	`JComponent.AccessibleJComponent`	Inner class of JComponent used to provide default support for accessibility.

Nested classes/interfaces declared in class Container

Container.AccessibleAWTContainer

Modifier and Type	Class	Description
`protected class`	`Container.AccessibleAWTContainer`	Inner class of Container used to provide default support for accessibility.

Nested classes/interfaces declared in class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Modifier and Type	Class	Description
`protected class`	`Component.AccessibleAWTComponent`	Inner class of Component used to provide default support for accessibility.
`static enum`	`Component.BaselineResizeBehavior`	Enumeration of the common ways the baseline of a component can change as the size changes.
`protected class`	`Component.BltBufferStrategy`	Inner class for blitting offscreen surfaces to a component.
`protected class`	`Component.FlipBufferStrategy`	Inner class for flipping buffers on a component.

Field Summary

Modifier and Type	Field	Description
`static final String`	`ANCHOR_SELECTION_PATH_PROPERTY`	Bound property name for anchor selection path.
`static final String`	`CELL_EDITOR_PROPERTY`	Bound property name for `cellEditor`.
`static final String`	`CELL_RENDERER_PROPERTY`	Bound property name for `cellRenderer`.
`protected TreeCellEditor`	`cellEditor`	Editor for the entries.
`protected TreeCellRenderer`	`cellRenderer`	The cell used to draw nodes.
`protected boolean`	`editable`	Is the tree editable?
`static final String`	`EDITABLE_PROPERTY`	Bound property name for `editable`.
`static final String`	`EXPANDS_SELECTED_PATHS_PROPERTY`	Bound property name for expands selected paths property
`static final String`	`INVOKES_STOP_CELL_EDITING_PROPERTY`	Bound property name for `messagesStopCellEditing`.
`protected boolean`	`invokesStopCellEditing`	If true, when editing is to be stopped by way of selection changing, data in tree changing or other means `stopCellEditing` is invoked, and changes are saved.
`static final String`	`LARGE_MODEL_PROPERTY`	Bound property name for `largeModel`.
`protected boolean`	`largeModel`	Is this tree a large model?
`static final String`	`LEAD_SELECTION_PATH_PROPERTY`	Bound property name for `leadSelectionPath`.
`static final String`	`ROOT_VISIBLE_PROPERTY`	Bound property name for `rootVisible`.
`protected boolean`	`rootVisible`	True if the root node is displayed, false if its children are the highest visible nodes.
`static final String`	`ROW_HEIGHT_PROPERTY`	Bound property name for `rowHeight`.
`protected int`	`rowHeight`	Height to use for each display row.
`static final String`	`SCROLLS_ON_EXPAND_PROPERTY`	Bound property name for `scrollsOnExpand`.
`protected boolean`	`scrollsOnExpand`	If true, when a node is expanded, as many of the descendants are scrolled to be visible.
`static final 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 the `selectionListeners`.
`static final String`	`SHOWS_ROOT_HANDLES_PROPERTY`	Bound property name for `showsRootHandles`.
`protected boolean`	`showsRootHandles`	True if handles are displayed at the topmost level of the tree.
`static final String`	`TOGGLE_CLICK_COUNT_PROPERTY`	Bound property name for `toggleClickCount`.
`protected int`	`toggleClickCount`	Number of mouse clicks before a node is expanded.
`static final String`	`TREE_MODEL_PROPERTY`	Bound property name for `treeModel`.
`protected TreeModel`	`treeModel`	The model that defines the tree displayed by this object.
`protected TreeModelListener`	`treeModelListener`	Updates the `expandedState`.
`static final String`	`VISIBLE_ROW_COUNT_PROPERTY`	Bound property name for `visibleRowCount`.
`protected int`	`visibleRowCount`	Number of rows to make visible at one time.

Fields declared in class JComponent

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

Modifier and Type	Field	Description
`protected EventListenerList`	`listenerList`	A list of event listeners for this component.
`static final String`	`TOOL_TIP_TEXT_KEY`	The comment to display when the cursor is over the component, also known as a "value tip", "flyover help", or "flyover label".
`protected ComponentUI`	`ui`	The look and feel delegate for this component.
`static final int`	`UNDEFINED_CONDITION`	Constant used by some of the APIs to mean that no condition is defined.
`static final int`	`WHEN_ANCESTOR_OF_FOCUSED_COMPONENT`	Constant used for `registerKeyboardAction` that means that the command should be invoked when the receiving component is an ancestor of the focused component or is itself the focused component.
`static final int`	`WHEN_FOCUSED`	Constant used for `registerKeyboardAction` that means that the command should be invoked when the component has the focus.
`static final int`	`WHEN_IN_FOCUSED_WINDOW`	Constant used for `registerKeyboardAction` that means that the command should be invoked when the receiving component is in the window that has the focus or is itself the focused component.

Fields declared in class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Modifier and Type	Field	Description
`protected AccessibleContext`	`accessibleContext`	The `AccessibleContext` associated with this `Component`.
`static final float`	`BOTTOM_ALIGNMENT`	Ease-of-use constant for `getAlignmentY`.
`static final float`	`CENTER_ALIGNMENT`	Ease-of-use constant for `getAlignmentY` and `getAlignmentX`.
`static final float`	`LEFT_ALIGNMENT`	Ease-of-use constant for `getAlignmentX`.
`static final float`	`RIGHT_ALIGNMENT`	Ease-of-use constant for `getAlignmentX`.
`static final float`	`TOP_ALIGNMENT`	Ease-of-use constant for `getAlignmentY()`.

Fields declared in interface ImageObserver

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

Modifier and Type	Field	Description
`static final int`	`ABORT`	This flag in the infoflags argument to imageUpdate indicates that an image which was being tracked asynchronously was aborted before production was complete.
`static final int`	`ALLBITS`	This flag in the infoflags argument to imageUpdate indicates that a static image which was previously drawn is now complete and can be drawn again in its final form.
`static final int`	`ERROR`	This flag in the infoflags argument to imageUpdate indicates that an image which was being tracked asynchronously has encountered an error.
`static final int`	`FRAMEBITS`	This flag in the infoflags argument to imageUpdate indicates that another complete frame of a multi-frame image which was previously drawn is now available to be drawn again.
`static final int`	`HEIGHT`	This flag in the infoflags argument to imageUpdate indicates that the height of the base image is now available and can be taken from the height argument to the imageUpdate callback method.
`static final int`	`PROPERTIES`	This flag in the infoflags argument to imageUpdate indicates that the properties of the image are now available.
`static final int`	`SOMEBITS`	This flag in the infoflags argument to imageUpdate indicates that more pixels needed for drawing a scaled variation of the image are available.
`static final int`	`WIDTH`	This flag in the infoflags argument to imageUpdate indicates that the width of the base image is now available and can be taken from the width argument to the imageUpdate callback method.

Constructor Summary

Constructor	Description
`JTree()`	Returns a `JTree` with a sample model.
`JTree(Object[] value)`	Returns a `JTree` with each element of the specified array as the child of a new root node which is not displayed.
`JTree(Hashtable<?,?> value)`	Returns a `JTree` created from a `Hashtable` which does not display with root.
`JTree(Vector<?> value)`	Returns a `JTree` with each element of the specified `Vector` as the child of a new root node which is not displayed.
`JTree(TreeModel newModel)`	Returns an instance of `JTree` which displays the root node -- the tree is created using the specified data model.
`JTree(TreeNode root)`	Returns a `JTree` with the specified `TreeNode` as its root, which displays the root node.
`JTree(TreeNode root, boolean asksAllowsChildren)`	Returns a `JTree` with the specified `TreeNode` as its root, which displays the root node and which decides whether a node is a leaf node in the specified manner.

Method Summary

Modifier and Type	Method	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 specified `TreePath` 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 for `TreeExpansion` events.
`void`	`addTreeSelectionListener(TreeSelectionListener tsl)`	Adds a listener for `TreeSelection` events.
`void`	`addTreeWillExpandListener(TreeWillExpandListener tel)`	Adds a listener for `TreeWillExpand` 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 a `TreeModel` wrapping the specified object.
`protected TreeModelListener`	`createTreeModelListener()`	Creates and returns an instance of `TreeModelHandler`.
`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 current `TreeCellRenderer` 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 sample `TreeModel`.
`protected Enumeration<TreePath>`	`getDescendantToggledPaths(TreePath parent)`	Returns an `Enumeration` of `TreePaths` that have been expanded that are descendants of `parent`.
`boolean`	`getDragEnabled()`	Returns whether or not automatic drag handling is enabled.
`final JTree.DropLocation`	`getDropLocation()`	Returns the location that this component should visually indicate as the drop location during a DnD operation over the component, or `null` if no location is to currently be shown.
`final 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 an `Enumeration` of the descendants of the path `parent` that are currently expanded.
`boolean`	`getExpandsSelectedPaths()`	Returns the `expandsSelectedPaths` 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 the `TreeModel` 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 the `Rectangle` 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 a `JTree`.
`Rectangle`	`getRowBounds(int row)`	Returns the `Rectangle` 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 of `visibleRect`, based on `orientation`.
`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 the `scrollsOnExpand` 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 the `showsRootHandles` property.
`int`	`getToggleClickCount()`	Returns the number of mouse clicks needed to expand or close a node.
`String`	`getToolTipText(MouseEvent event)`	Overrides `JComponent`'s `getToolTipText` method in order to allow renderer's tips to be used if it has text set.
`TreeExpansionListener[]`	`getTreeExpansionListeners()`	Returns an array of all the `TreeExpansionListener`s added to this JTree with addTreeExpansionListener().
`TreeSelectionListener[]`	`getTreeSelectionListeners()`	Returns an array of all the `TreeSelectionListener`s added to this JTree with addTreeSelectionListener().
`TreeWillExpandListener[]`	`getTreeWillExpandListeners()`	Returns an array of all the `TreeWillExpandListener`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)`	Returns `isEditable`.
`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 this `JTree`.
`protected boolean`	`removeDescendantSelectedPaths(TreePath path, boolean includePath)`	Removes any paths in the selection that are descendants of `path`.
`protected void`	`removeDescendantToggledPaths(Enumeration<TreePath> toRemove)`	Removes any descendants of the `TreePaths` in `toRemove` 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 index `row` 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 for `TreeExpansion` events.
`void`	`removeTreeSelectionListener(TreeSelectionListener tsl)`	Removes a `TreeSelection` listener.
`void`	`removeTreeWillExpandListener(TreeWillExpandListener tel)`	Removes a listener for `TreeWillExpand` 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 the `TreeCellRenderer` that will be used to draw each cell.
`void`	`setDragEnabled(boolean b)`	Turns on or off automatic drag handling.
`final 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 this `JTree`.
`void`	`setExpandsSelectedPaths(boolean newValue)`	Configures the `expandsSelectedPaths` 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 the `TreeModel` that will provide the data.
`void`	`setRootVisible(boolean rootVisible)`	Determines whether or not the root node from the `TreeModel` is visible.
`void`	`setRowHeight(int rowHeight)`	Sets the height of each cell, in pixels.
`void`	`setScrollsOnExpand(boolean newValue)`	Sets the `scrollsOnExpand` 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 the `showsRootHandles` 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 the `UIManager` that the L&F has changed.

Methods declared in class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, 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

Modifier and Type	Method	Description
`void`	`addAncestorListener(AncestorListener listener)`	Registers `listener` so that it will receive `AncestorEvents` when it or any of its ancestors move or are made visible or invisible.
`void`	`addNotify()`	Notifies this component that it now has a parent component.
`void`	`addVetoableChangeListener(VetoableChangeListener listener)`	Adds a `VetoableChangeListener` to the listener list.
`void`	`computeVisibleRect(Rectangle visibleRect)`	Returns the `Component`'s "visible rect rectangle" - the intersection of the visible rectangles for this component and all of its ancestors.
`boolean`	`contains(int x, int y)`	Gives the UI delegate an opportunity to define the precise shape of this component for the sake of mouse processing.
`JToolTip`	`createToolTip()`	Returns the instance of `JToolTip` that should be used to display the tooltip.
`void`	`disable()`	Deprecated. As of JDK version 1.1, replaced by `java.awt.Component.setEnabled(boolean)`.
`void`	`enable()`	Deprecated. As of JDK version 1.1, replaced by `java.awt.Component.setEnabled(boolean)`.
`void`	`firePropertyChange(String propertyName, boolean oldValue, boolean newValue)`	Support for reporting bound property changes for boolean properties.
`void`	`firePropertyChange(String propertyName, int oldValue, int newValue)`	Support for reporting bound property changes for integer properties.
`protected void`	`fireVetoableChange(String propertyName, Object oldValue, Object newValue)`	Supports reporting constrained property changes.
`ActionListener`	`getActionForKeyStroke(KeyStroke aKeyStroke)`	Returns the object that will perform the action registered for a given keystroke.
`final ActionMap`	`getActionMap()`	Returns the `ActionMap` used to determine what `Action` to fire for particular `KeyStroke` binding.
`float`	`getAlignmentX()`	Overrides `Container.getAlignmentX` to return the horizontal alignment.
`float`	`getAlignmentY()`	Overrides `Container.getAlignmentY` to return the vertical alignment.
`AncestorListener[]`	`getAncestorListeners()`	Returns an array of all the ancestor listeners registered on this component.
`boolean`	`getAutoscrolls()`	Gets the `autoscrolls` property.
`int`	`getBaseline(int width, int height)`	Returns the baseline.
`Component.BaselineResizeBehavior`	`getBaselineResizeBehavior()`	Returns an enum indicating how the baseline of the component changes as the size changes.
`Border`	`getBorder()`	Returns the border of this component or `null` if no border is currently set.
`Rectangle`	`getBounds(Rectangle rv)`	Stores the bounds of this component into "return value" `rv` and returns `rv`.
`final Object`	`getClientProperty(Object key)`	Returns the value of the property with the specified key.
`protected Graphics`	`getComponentGraphics(Graphics g)`	Returns the graphics object used to paint this component.
`JPopupMenu`	`getComponentPopupMenu()`	Returns `JPopupMenu` that assigned for this component.
`int`	`getConditionForKeyStroke(KeyStroke aKeyStroke)`	Returns the condition that determines whether a registered action occurs in response to the specified keystroke.
`int`	`getDebugGraphicsOptions()`	Returns the state of graphics debugging.
`static Locale`	`getDefaultLocale()`	Returns the default locale used to initialize each JComponent's locale property upon creation.
`FontMetrics`	`getFontMetrics(Font font)`	Gets the `FontMetrics` for the specified `Font`.
`Graphics`	`getGraphics()`	Returns this component's graphics context, which lets you draw on a component.
`int`	`getHeight()`	Returns the current height of this component.
`boolean`	`getInheritsPopupMenu()`	Returns true if the JPopupMenu should be inherited from the parent.
`final InputMap`	`getInputMap()`	Returns the `InputMap` that is used when the component has focus.
`final InputMap`	`getInputMap(int condition)`	Returns the `InputMap` that is used during `condition`.
`InputVerifier`	`getInputVerifier()`	Returns the input verifier for this component.
`Insets`	`getInsets()`	If a border has been set on this component, returns the border's insets; otherwise calls `super.getInsets`.
`Insets`	`getInsets(Insets insets)`	Returns an `Insets` object containing this component's inset values.
`<T extends EventListener> T[]`	`getListeners(Class<T> listenerType)`	Returns an array of all the objects currently registered as `FooListener`s upon this `JComponent`.
`Point`	`getLocation(Point rv)`	Stores the x,y origin of this component into "return value" `rv` and returns `rv`.
`Dimension`	`getMaximumSize()`	If the maximum size has been set to a non-`null` value just returns it.
`Dimension`	`getMinimumSize()`	If the minimum size has been set to a non-`null` value just returns it.
`Component`	`getNextFocusableComponent()`	Deprecated. As of 1.4, replaced by `FocusTraversalPolicy`.
`Point`	`getPopupLocation(MouseEvent event)`	Returns the preferred location to display the popup menu in this component's coordinate system.
`Dimension`	`getPreferredSize()`	If the `preferredSize` has been set to a non-`null` value just returns it.
`KeyStroke[]`	`getRegisteredKeyStrokes()`	Returns the `KeyStrokes` that will initiate registered actions.
`JRootPane`	`getRootPane()`	Returns the `JRootPane` ancestor for this component.
`Dimension`	`getSize(Dimension rv)`	Stores the width/height of this component into "return value" `rv` and returns `rv`.
`Point`	`getToolTipLocation(MouseEvent event)`	Returns the tooltip location in this component's coordinate system.
`String`	`getToolTipText()`	Returns the tooltip string that has been set with `setToolTipText`.
`Container`	`getTopLevelAncestor()`	Returns the top-level ancestor of this component (the containing `Window`) or `null` if this component has not been added to any container.
`TransferHandler`	`getTransferHandler()`	Gets the `transferHandler` property.
`boolean`	`getVerifyInputWhenFocusTarget()`	Returns the value that indicates whether the input verifier for the current focus owner will be called before this component requests focus.
`VetoableChangeListener[]`	`getVetoableChangeListeners()`	Returns an array of all the vetoable change listeners registered on this component.
`Rectangle`	`getVisibleRect()`	Returns the `Component`'s "visible rectangle" - the intersection of this component's visible rectangle, `new Rectangle(0, 0, getWidth(), getHeight())`, and all of its ancestors' visible rectangles.
`int`	`getWidth()`	Returns the current width of this component.
`int`	`getX()`	Returns the current x coordinate of the component's origin.
`int`	`getY()`	Returns the current y coordinate of the component's origin.
`void`	`grabFocus()`	Requests that this Component get the input focus, and that this Component's top-level ancestor become the focused Window.
`void`	`hide()`	Deprecated.
`boolean`	`isDoubleBuffered()`	Returns whether this component should use a buffer to paint.
`static boolean`	`isLightweightComponent(Component c)`	Returns true if this component is lightweight, that is, if it doesn't have a native window system peer.
`boolean`	`isManagingFocus()`	Deprecated. As of 1.4, replaced by `Component.setFocusTraversalKeys(int, Set)` and `Container.setFocusCycleRoot(boolean)`.
`boolean`	`isOpaque()`	Returns true if this component is completely opaque.
`boolean`	`isOptimizedDrawingEnabled()`	Returns true if this component tiles its children -- that is, if it can guarantee that the children will not overlap.
`final boolean`	`isPaintingForPrint()`	Returns `true` if the current painting operation on this component is part of a `print` operation.
`protected boolean`	`isPaintingOrigin()`	Returns `true` if a paint triggered on a child component should cause painting to originate from this Component, or one of its ancestors.
`boolean`	`isPaintingTile()`	Returns true if the component is currently painting a tile.
`boolean`	`isRequestFocusEnabled()`	Returns `true` if this `JComponent` should get focus; otherwise returns `false`.
`boolean`	`isValidateRoot()`	If this method returns true, `revalidate` calls by descendants of this component will cause the entire tree beginning with this root to be validated.
`void`	`paint(Graphics g)`	Invoked by Swing to draw components.
`protected void`	`paintBorder(Graphics g)`	Paints the component's border.
`protected void`	`paintChildren(Graphics g)`	Paints this component's children.
`protected void`	`paintComponent(Graphics g)`	Calls the UI delegate's paint method, if the UI delegate is non-`null`.
`void`	`paintImmediately(int x, int y, int w, int h)`	Paints the specified region in this component and all of its descendants that overlap the region, immediately.
`void`	`paintImmediately(Rectangle r)`	Paints the specified region now.
`void`	`print(Graphics g)`	Invoke this method to print the component to the specified `Graphics`.
`void`	`printAll(Graphics g)`	Invoke this method to print the component.
`protected void`	`printBorder(Graphics g)`	Prints the component's border.
`protected void`	`printChildren(Graphics g)`	Prints this component's children.
`protected void`	`printComponent(Graphics g)`	This is invoked during a printing operation.
`protected void`	`processComponentKeyEvent(KeyEvent e)`	Processes any key events that the component itself recognizes.
`protected boolean`	`processKeyBinding(KeyStroke ks, KeyEvent e, int condition, boolean pressed)`	Invoked to process the key bindings for `ks` as the result of the `KeyEvent` `e`.
`protected void`	`processKeyEvent(KeyEvent e)`	Overrides `processKeyEvent` to process events.
`protected void`	`processMouseEvent(MouseEvent e)`	Processes mouse events occurring on this component by dispatching them to any registered `MouseListener` objects, refer to `Component.processMouseEvent(MouseEvent)` for a complete description of this method.
`protected void`	`processMouseMotionEvent(MouseEvent e)`	Processes mouse motion events, such as MouseEvent.MOUSE_DRAGGED.
`final void`	`putClientProperty(Object key, Object value)`	Adds an arbitrary key/value "client property" to this component.
`void`	`registerKeyboardAction(ActionListener anAction, String aCommand, KeyStroke aKeyStroke, int aCondition)`	This method is now obsolete, please use a combination of `getActionMap()` and `getInputMap()` for similar behavior.
`void`	`registerKeyboardAction(ActionListener anAction, KeyStroke aKeyStroke, int aCondition)`	This method is now obsolete, please use a combination of `getActionMap()` and `getInputMap()` for similar behavior.
`void`	`removeAncestorListener(AncestorListener listener)`	Unregisters `listener` so that it will no longer receive `AncestorEvents`.
`void`	`removeNotify()`	Notifies this component that it no longer has a parent component.
`void`	`removeVetoableChangeListener(VetoableChangeListener listener)`	Removes a `VetoableChangeListener` from the listener list.
`void`	`repaint(long tm, int x, int y, int width, int height)`	Adds the specified region to the dirty region list if the component is showing.
`void`	`repaint(Rectangle r)`	Adds the specified region to the dirty region list if the component is showing.
`boolean`	`requestDefaultFocus()`	Deprecated. As of 1.4, replaced by `FocusTraversalPolicy.getDefaultComponent(Container).requestFocus()`
`void`	`requestFocus()`	Requests that this `Component` gets the input focus.
`boolean`	`requestFocus(boolean temporary)`	Requests that this `Component` gets the input focus.
`boolean`	`requestFocusInWindow()`	Requests that this `Component` gets the input focus.
`protected boolean`	`requestFocusInWindow(boolean temporary)`	Requests that this `Component` gets the input focus.
`void`	`resetKeyboardActions()`	Unregisters all the bindings in the first tier `InputMaps` and `ActionMap`.
`void`	`reshape(int x, int y, int w, int h)`	Deprecated. As of JDK 5, replaced by `Component.setBounds(int, int, int, int)`.
`void`	`revalidate()`	Supports deferred automatic layout.
`void`	`scrollRectToVisible(Rectangle aRect)`	Forwards the `scrollRectToVisible()` message to the `JComponent`'s parent.
`final void`	`setActionMap(ActionMap am)`	Sets the `ActionMap` to `am`.
`void`	`setAlignmentX(float alignmentX)`	Sets the horizontal alignment.
`void`	`setAlignmentY(float alignmentY)`	Sets the vertical alignment.
`void`	`setAutoscrolls(boolean autoscrolls)`	Sets the `autoscrolls` property.
`void`	`setBackground(Color bg)`	Sets the background color of this component.
`void`	`setBorder(Border border)`	Sets the border of this component.
`void`	`setComponentPopupMenu(JPopupMenu popup)`	Sets the `JPopupMenu` for this `JComponent`.
`void`	`setDebugGraphicsOptions(int debugOptions)`	Enables or disables diagnostic information about every graphics operation performed within the component or one of its children.
`static void`	`setDefaultLocale(Locale l)`	Sets the default locale used to initialize each JComponent's locale property upon creation.
`void`	`setDoubleBuffered(boolean aFlag)`	Sets whether this component should use a buffer to paint.
`void`	`setEnabled(boolean enabled)`	Sets whether or not this component is enabled.
`void`	`setFocusTraversalKeys(int id, Set<? extends AWTKeyStroke> keystrokes)`	Sets the focus traversal keys for a given traversal operation for this Component.
`void`	`setFont(Font font)`	Sets the font for this component.
`void`	`setForeground(Color fg)`	Sets the foreground color of this component.
`void`	`setInheritsPopupMenu(boolean value)`	Sets whether or not `getComponentPopupMenu` should delegate to the parent if this component does not have a `JPopupMenu` assigned to it.
`final void`	`setInputMap(int condition, InputMap map)`	Sets the `InputMap` to use under the condition `condition` to `map`.
`void`	`setInputVerifier(InputVerifier inputVerifier)`	Sets the input verifier for this component.
`void`	`setMaximumSize(Dimension maximumSize)`	Sets the maximum size of this component to a constant value.
`void`	`setMinimumSize(Dimension minimumSize)`	Sets the minimum size of this component to a constant value.
`void`	`setNextFocusableComponent(Component aComponent)`	Deprecated. As of 1.4, replaced by `FocusTraversalPolicy`
`void`	`setOpaque(boolean isOpaque)`	If true the component paints every pixel within its bounds.
`void`	`setPreferredSize(Dimension preferredSize)`	Sets the preferred size of this component.
`void`	`setRequestFocusEnabled(boolean requestFocusEnabled)`	Provides a hint as to whether or not this `JComponent` should get focus.
`void`	`setToolTipText(String text)`	Registers the text to display in a tool tip.
`void`	`setTransferHandler(TransferHandler newHandler)`	Sets the `TransferHandler`, which provides support for transfer of data into and out of this component via cut/copy/paste and drag and drop.
`protected void`	`setUI(ComponentUI newUI)`	Sets the look and feel delegate for this component.
`void`	`setVerifyInputWhenFocusTarget(boolean verifyInputWhenFocusTarget)`	Sets the value to indicate whether input verifier for the current focus owner will be called before this component requests focus.
`void`	`setVisible(boolean aFlag)`	Makes the component visible or invisible.
`void`	`unregisterKeyboardAction(KeyStroke aKeyStroke)`	This method is now obsolete.
`void`	`update(Graphics g)`	Calls `paint`.

Methods declared in class 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

Modifier and Type	Method	Description
`Component`	`add(Component comp)`	Appends the specified component to the end of this container.
`Component`	`add(Component comp, int index)`	Adds the specified component to this container at the given position.
`void`	`add(Component comp, Object constraints)`	Adds the specified component to the end of this container.
`void`	`add(Component comp, Object constraints, int index)`	Adds the specified component to this container with the specified constraints at the specified index.
`Component`	`add(String name, Component comp)`	Adds the specified component to this container.
`void`	`addContainerListener(ContainerListener l)`	Adds the specified container listener to receive container events from this container.
`protected void`	`addImpl(Component comp, Object constraints, int index)`	Adds the specified component to this container at the specified index.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Adds a PropertyChangeListener to the listener list.
`void`	`addPropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Adds a PropertyChangeListener to the listener list for a specific property.
`void`	`applyComponentOrientation(ComponentOrientation o)`	Sets the `ComponentOrientation` property of this container and all components contained within it.
`boolean`	`areFocusTraversalKeysSet(int id)`	Returns whether the Set of focus traversal keys for the given focus traversal operation has been explicitly defined for this Container.
`int`	`countComponents()`	Deprecated. As of JDK version 1.1, replaced by getComponentCount().
`void`	`deliverEvent(Event e)`	Deprecated. As of JDK version 1.1, replaced by `dispatchEvent(AWTEvent e)`
`void`	`doLayout()`	Causes this container to lay out its components.
`Component`	`findComponentAt(int x, int y)`	Locates the visible child component that contains the specified position.
`Component`	`findComponentAt(Point p)`	Locates the visible child component that contains the specified point.
`Component`	`getComponent(int n)`	Gets the nth component in this container.
`Component`	`getComponentAt(int x, int y)`	Locates the component that contains the x,y position.
`Component`	`getComponentAt(Point p)`	Gets the component that contains the specified point.
`int`	`getComponentCount()`	Gets the number of components in this panel.
`Component[]`	`getComponents()`	Gets all the components in this container.
`int`	`getComponentZOrder(Component comp)`	Returns the z-order index of the component inside the container.
`ContainerListener[]`	`getContainerListeners()`	Returns an array of all the container listeners registered on this container.
`Set<AWTKeyStroke>`	`getFocusTraversalKeys(int id)`	Returns the Set of focus traversal keys for a given traversal operation for this Container.
`FocusTraversalPolicy`	`getFocusTraversalPolicy()`	Returns the focus traversal policy that will manage keyboard traversal of this Container's children, or null if this Container is not a focus cycle root.
`LayoutManager`	`getLayout()`	Gets the layout manager for this container.
`Point`	`getMousePosition(boolean allowChildren)`	Returns the position of the mouse pointer in this `Container`'s coordinate space if the `Container` is under the mouse pointer, otherwise returns `null`.
`Insets`	`insets()`	Deprecated. As of JDK version 1.1, replaced by `getInsets()`.
`void`	`invalidate()`	Invalidates the container.
`boolean`	`isAncestorOf(Component c)`	Checks if the component is contained in the component hierarchy of this container.
`boolean`	`isFocusCycleRoot()`	Returns whether this Container is the root of a focus traversal cycle.
`boolean`	`isFocusCycleRoot(Container container)`	Returns whether the specified Container is the focus cycle root of this Container's focus traversal cycle.
`final boolean`	`isFocusTraversalPolicyProvider()`	Returns whether this container provides focus traversal policy.
`boolean`	`isFocusTraversalPolicySet()`	Returns whether the focus traversal policy has been explicitly set for this Container.
`void`	`layout()`	Deprecated. As of JDK version 1.1, replaced by `doLayout()`.
`void`	`list(PrintStream out, int indent)`	Prints a listing of this container to the specified output stream.
`void`	`list(PrintWriter out, int indent)`	Prints out a list, starting at the specified indentation, to the specified print writer.
`Component`	`locate(int x, int y)`	Deprecated. As of JDK version 1.1, replaced by `getComponentAt(int, int)`.
`Dimension`	`minimumSize()`	Deprecated. As of JDK version 1.1, replaced by `getMinimumSize()`.
`void`	`paintComponents(Graphics g)`	Paints each of the components in this container.
`Dimension`	`preferredSize()`	Deprecated. As of JDK version 1.1, replaced by `getPreferredSize()`.
`void`	`printComponents(Graphics g)`	Prints each of the components in this container.
`protected void`	`processContainerEvent(ContainerEvent e)`	Processes container events occurring on this container by dispatching them to any registered ContainerListener objects.
`protected void`	`processEvent(AWTEvent e)`	Processes events on this container.
`void`	`remove(int index)`	Removes the component, specified by `index`, from this container.
`void`	`remove(Component comp)`	Removes the specified component from this container.
`void`	`removeAll()`	Removes all the components from this container.
`void`	`removeContainerListener(ContainerListener l)`	Removes the specified container listener so it no longer receives container events from this container.
`void`	`setComponentZOrder(Component comp, int index)`	Moves the specified component to the specified z-order index in the container.
`void`	`setFocusCycleRoot(boolean focusCycleRoot)`	Sets whether this Container is the root of a focus traversal cycle.
`void`	`setFocusTraversalPolicy(FocusTraversalPolicy policy)`	Sets the focus traversal policy that will manage keyboard traversal of this Container's children, if this Container is a focus cycle root.
`final void`	`setFocusTraversalPolicyProvider(boolean provider)`	Sets whether this container will be used to provide focus traversal policy.
`void`	`setLayout(LayoutManager mgr)`	Sets the layout manager for this container.
`void`	`transferFocusDownCycle()`	Transfers the focus down one focus traversal cycle.
`void`	`validate()`	Validates this container and all of its subcomponents.
`protected void`	`validateTree()`	Recursively descends the container tree and recomputes the layout for any subtrees marked as needing it (those marked as invalid).

Methods declared in class 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, 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, 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, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Modifier and Type	Method	Description
`boolean`	`action(Event evt, Object what)`	Deprecated. As of JDK version 1.1, should register this component as ActionListener on component which fires action events.
`void`	`add(PopupMenu popup)`	Adds the specified popup menu to the component.
`void`	`addComponentListener(ComponentListener l)`	Adds the specified component listener to receive component events from this component.
`void`	`addFocusListener(FocusListener l)`	Adds the specified focus listener to receive focus events from this component when this component gains input focus.
`void`	`addHierarchyBoundsListener(HierarchyBoundsListener l)`	Adds the specified hierarchy bounds listener to receive hierarchy bounds events from this component when the hierarchy to which this container belongs changes.
`void`	`addHierarchyListener(HierarchyListener l)`	Adds the specified hierarchy listener to receive hierarchy changed events from this component when the hierarchy to which this container belongs changes.
`void`	`addInputMethodListener(InputMethodListener l)`	Adds the specified input method listener to receive input method events from this component.
`void`	`addKeyListener(KeyListener l)`	Adds the specified key listener to receive key events from this component.
`void`	`addMouseListener(MouseListener l)`	Adds the specified mouse listener to receive mouse events from this component.
`void`	`addMouseMotionListener(MouseMotionListener l)`	Adds the specified mouse motion listener to receive mouse motion events from this component.
`void`	`addMouseWheelListener(MouseWheelListener l)`	Adds the specified mouse wheel listener to receive mouse wheel events from this component.
`Rectangle`	`bounds()`	Deprecated. As of JDK version 1.1, replaced by `getBounds()`.
`int`	`checkImage(Image image, int width, int height, ImageObserver observer)`	Returns the status of the construction of a screen representation of the specified image.
`int`	`checkImage(Image image, ImageObserver observer)`	Returns the status of the construction of a screen representation of the specified image.
`protected AWTEvent`	`coalesceEvents(AWTEvent existingEvent, AWTEvent newEvent)`	Potentially coalesce an event being posted with an existing event.
`boolean`	`contains(Point p)`	Checks whether this component "contains" the specified point, where the point's x and y coordinates are defined to be relative to the coordinate system of this component.
`Image`	`createImage(int width, int height)`	Creates an off-screen drawable image to be used for double buffering.
`Image`	`createImage(ImageProducer producer)`	Creates an image from the specified image producer.
`VolatileImage`	`createVolatileImage(int width, int height)`	Creates a volatile off-screen drawable image to be used for double buffering.
`VolatileImage`	`createVolatileImage(int width, int height, ImageCapabilities caps)`	Creates a volatile off-screen drawable image, with the given capabilities.
`protected final void`	`disableEvents(long eventsToDisable)`	Disables the events defined by the specified event mask parameter from being delivered to this component.
`final void`	`dispatchEvent(AWTEvent e)`	Dispatches an event to this component or one of its sub components.
`void`	`enable(boolean b)`	Deprecated. As of JDK version 1.1, replaced by `setEnabled(boolean)`.
`protected final void`	`enableEvents(long eventsToEnable)`	Enables the events defined by the specified event mask parameter to be delivered to this component.
`void`	`enableInputMethods(boolean enable)`	Enables or disables input method support for this component.
`void`	`firePropertyChange(String propertyName, byte oldValue, byte newValue)`	Reports a bound property change.
`void`	`firePropertyChange(String propertyName, char oldValue, char newValue)`	Reports a bound property change.
`void`	`firePropertyChange(String propertyName, double oldValue, double newValue)`	Reports a bound property change.
`void`	`firePropertyChange(String propertyName, float oldValue, float newValue)`	Reports a bound property change.
`void`	`firePropertyChange(String propertyName, long oldValue, long newValue)`	Reports a bound property change.
`void`	`firePropertyChange(String propertyName, short oldValue, short newValue)`	Reports a bound property change.
`protected void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Support for reporting bound property changes for Object properties.
`Color`	`getBackground()`	Gets the background color of this component.
`Rectangle`	`getBounds()`	Gets the bounds of this component in the form of a `Rectangle` object.
`ColorModel`	`getColorModel()`	Gets the instance of `ColorModel` used to display the component on the output device.
`ComponentListener[]`	`getComponentListeners()`	Returns an array of all the component listeners registered on this component.
`ComponentOrientation`	`getComponentOrientation()`	Retrieves the language-sensitive orientation that is to be used to order the elements or text within this component.
`Cursor`	`getCursor()`	Gets the cursor set in the component.
`DropTarget`	`getDropTarget()`	Gets the `DropTarget` associated with this `Component`.
`Container`	`getFocusCycleRootAncestor()`	Returns the Container which is the focus cycle root of this Component's focus traversal cycle.
`FocusListener[]`	`getFocusListeners()`	Returns an array of all the focus listeners registered on this component.
`boolean`	`getFocusTraversalKeysEnabled()`	Returns whether focus traversal keys are enabled for this Component.
`Font`	`getFont()`	Gets the font of this component.
`Color`	`getForeground()`	Gets the foreground color of this component.
`GraphicsConfiguration`	`getGraphicsConfiguration()`	Gets the `GraphicsConfiguration` associated with this `Component`.
`HierarchyBoundsListener[]`	`getHierarchyBoundsListeners()`	Returns an array of all the hierarchy bounds listeners registered on this component.
`HierarchyListener[]`	`getHierarchyListeners()`	Returns an array of all the hierarchy listeners registered on this component.
`boolean`	`getIgnoreRepaint()`	Returns whether or not paint messages received from the operating system should be ignored.
`InputContext`	`getInputContext()`	Gets the input context used by this component for handling the communication with input methods when text is entered in this component.
`InputMethodListener[]`	`getInputMethodListeners()`	Returns an array of all the input method listeners registered on this component.
`InputMethodRequests`	`getInputMethodRequests()`	Gets the input method request handler which supports requests from input methods for this component.
`KeyListener[]`	`getKeyListeners()`	Returns an array of all the key listeners registered on this component.
`Locale`	`getLocale()`	Gets the locale of this component.
`Point`	`getLocation()`	Gets the location of this component in the form of a point specifying the component's top-left corner.
`Point`	`getLocationOnScreen()`	Gets the location of this component in the form of a point specifying the component's top-left corner in the screen's coordinate space.
`MouseListener[]`	`getMouseListeners()`	Returns an array of all the mouse listeners registered on this component.
`MouseMotionListener[]`	`getMouseMotionListeners()`	Returns an array of all the mouse motion listeners registered on this component.
`Point`	`getMousePosition()`	Returns the position of the mouse pointer in this `Component`'s coordinate space if the `Component` is directly under the mouse pointer, otherwise returns `null`.
`MouseWheelListener[]`	`getMouseWheelListeners()`	Returns an array of all the mouse wheel listeners registered on this component.
`String`	`getName()`	Gets the name of the component.
`Container`	`getParent()`	Gets the parent of this component.
`PropertyChangeListener[]`	`getPropertyChangeListeners()`	Returns an array of all the property change listeners registered on this component.
`PropertyChangeListener[]`	`getPropertyChangeListeners(String propertyName)`	Returns an array of all the listeners which have been associated with the named property.
`Dimension`	`getSize()`	Returns the size of this component in the form of a `Dimension` object.
`Toolkit`	`getToolkit()`	Gets the toolkit of this component.
`final Object`	`getTreeLock()`	Gets this component's locking object (the object that owns the thread synchronization monitor) for AWT component-tree and layout operations.
`boolean`	`gotFocus(Event evt, Object what)`	Deprecated. As of JDK version 1.1, replaced by processFocusEvent(FocusEvent).
`boolean`	`handleEvent(Event evt)`	Deprecated. As of JDK version 1.1 replaced by processEvent(AWTEvent).
`boolean`	`hasFocus()`	Returns `true` if this `Component` is the focus owner.
`boolean`	`imageUpdate(Image img, int infoflags, int x, int y, int w, int h)`	Repaints the component when the image has changed.
`boolean`	`inside(int x, int y)`	Deprecated. As of JDK version 1.1, replaced by contains(int, int).
`boolean`	`isBackgroundSet()`	Returns whether the background color has been explicitly set for this Component.
`boolean`	`isCursorSet()`	Returns whether the cursor has been explicitly set for this Component.
`boolean`	`isDisplayable()`	Determines whether this component is displayable.
`boolean`	`isEnabled()`	Determines whether this component is enabled.
`boolean`	`isFocusable()`	Returns whether this Component can be focused.
`boolean`	`isFocusOwner()`	Returns `true` if this `Component` is the focus owner.
`boolean`	`isFocusTraversable()`	Deprecated. As of 1.4, replaced by `isFocusable()`.
`boolean`	`isFontSet()`	Returns whether the font has been explicitly set for this Component.
`boolean`	`isForegroundSet()`	Returns whether the foreground color has been explicitly set for this Component.
`boolean`	`isLightweight()`	A lightweight component doesn't have a native toolkit peer.
`boolean`	`isMaximumSizeSet()`	Returns true if the maximum size has been set to a non-`null` value otherwise returns false.
`boolean`	`isMinimumSizeSet()`	Returns whether or not `setMinimumSize` has been invoked with a non-null value.
`boolean`	`isPreferredSizeSet()`	Returns true if the preferred size has been set to a non-`null` value otherwise returns false.
`boolean`	`isShowing()`	Determines whether this component is showing on screen.
`boolean`	`isValid()`	Determines whether this component is valid.
`boolean`	`isVisible()`	Determines whether this component should be visible when its parent is visible.
`boolean`	`keyDown(Event evt, int key)`	Deprecated. As of JDK version 1.1, replaced by processKeyEvent(KeyEvent).
`boolean`	`keyUp(Event evt, int key)`	Deprecated. As of JDK version 1.1, replaced by processKeyEvent(KeyEvent).
`void`	`list()`	Prints a listing of this component to the standard system output stream `System.out`.
`void`	`list(PrintStream out)`	Prints a listing of this component to the specified output stream.
`void`	`list(PrintWriter out)`	Prints a listing to the specified print writer.
`Point`	`location()`	Deprecated. As of JDK version 1.1, replaced by `getLocation()`.
`boolean`	`lostFocus(Event evt, Object what)`	Deprecated. As of JDK version 1.1, replaced by processFocusEvent(FocusEvent).
`boolean`	`mouseDown(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).
`boolean`	`mouseDrag(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseMotionEvent(MouseEvent).
`boolean`	`mouseEnter(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).
`boolean`	`mouseExit(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).
`boolean`	`mouseMove(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseMotionEvent(MouseEvent).
`boolean`	`mouseUp(Event evt, int x, int y)`	Deprecated. As of JDK version 1.1, replaced by processMouseEvent(MouseEvent).
`void`	`move(int x, int y)`	Deprecated. As of JDK version 1.1, replaced by `setLocation(int, int)`.
`void`	`nextFocus()`	Deprecated. As of JDK version 1.1, replaced by transferFocus().
`void`	`paintAll(Graphics g)`	Paints this component and all of its subcomponents.
`boolean`	`postEvent(Event e)`	Deprecated. As of JDK version 1.1, replaced by dispatchEvent(AWTEvent).
`boolean`	`prepareImage(Image image, int width, int height, ImageObserver observer)`	Prepares an image for rendering on this component at the specified width and height.
`boolean`	`prepareImage(Image image, ImageObserver observer)`	Prepares an image for rendering on this component.
`protected void`	`processComponentEvent(ComponentEvent e)`	Processes component events occurring on this component by dispatching them to any registered `ComponentListener` objects.
`protected void`	`processFocusEvent(FocusEvent e)`	Processes focus events occurring on this component by dispatching them to any registered `FocusListener` objects.
`protected void`	`processHierarchyBoundsEvent(HierarchyEvent e)`	Processes hierarchy bounds events occurring on this component by dispatching them to any registered `HierarchyBoundsListener` objects.
`protected void`	`processHierarchyEvent(HierarchyEvent e)`	Processes hierarchy events occurring on this component by dispatching them to any registered `HierarchyListener` objects.
`protected void`	`processInputMethodEvent(InputMethodEvent e)`	Processes input method events occurring on this component by dispatching them to any registered `InputMethodListener` objects.
`protected void`	`processMouseWheelEvent(MouseWheelEvent e)`	Processes mouse wheel events occurring on this component by dispatching them to any registered `MouseWheelListener` objects.
`void`	`remove(MenuComponent popup)`	Removes the specified popup menu from the component.
`void`	`removeComponentListener(ComponentListener l)`	Removes the specified component listener so that it no longer receives component events from this component.
`void`	`removeFocusListener(FocusListener l)`	Removes the specified focus listener so that it no longer receives focus events from this component.
`void`	`removeHierarchyBoundsListener(HierarchyBoundsListener l)`	Removes the specified hierarchy bounds listener so that it no longer receives hierarchy bounds events from this component.
`void`	`removeHierarchyListener(HierarchyListener l)`	Removes the specified hierarchy listener so that it no longer receives hierarchy changed events from this component.
`void`	`removeInputMethodListener(InputMethodListener l)`	Removes the specified input method listener so that it no longer receives input method events from this component.
`void`	`removeKeyListener(KeyListener l)`	Removes the specified key listener so that it no longer receives key events from this component.
`void`	`removeMouseListener(MouseListener l)`	Removes the specified mouse listener so that it no longer receives mouse events from this component.
`void`	`removeMouseMotionListener(MouseMotionListener l)`	Removes the specified mouse motion listener so that it no longer receives mouse motion events from this component.
`void`	`removeMouseWheelListener(MouseWheelListener l)`	Removes the specified mouse wheel listener so that it no longer receives mouse wheel events from this component.
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Removes a PropertyChangeListener from the listener list.
`void`	`removePropertyChangeListener(String propertyName, PropertyChangeListener listener)`	Removes a `PropertyChangeListener` from the listener list for a specific property.
`void`	`repaint()`	Repaints this component.
`void`	`repaint(int x, int y, int width, int height)`	Repaints the specified rectangle of this component.
`void`	`repaint(long tm)`	Repaints the component.
`protected boolean`	`requestFocus(boolean temporary, FocusEvent.Cause cause)`	Requests by the reason of `cause` that this `Component` get the input focus, and that this `Component`'s top-level ancestor become the focused `Window`.
`void`	`requestFocus(FocusEvent.Cause cause)`	Requests by the reason of `cause` that this Component get the input focus, and that this Component's top-level ancestor become the focused Window.
`boolean`	`requestFocusInWindow(FocusEvent.Cause cause)`	Requests by the reason of `cause` that this Component get the input focus, if this Component's top-level ancestor is already the focused Window.
`void`	`resize(int width, int height)`	Deprecated. As of JDK version 1.1, replaced by `setSize(int, int)`.
`void`	`resize(Dimension d)`	Deprecated. As of JDK version 1.1, replaced by `setSize(Dimension)`.
`void`	`setBounds(int x, int y, int width, int height)`	Moves and resizes this component.
`void`	`setBounds(Rectangle r)`	Moves and resizes this component to conform to the new bounding rectangle `r`.
`void`	`setComponentOrientation(ComponentOrientation o)`	Sets the language-sensitive orientation that is to be used to order the elements or text within this component.
`void`	`setCursor(Cursor cursor)`	Sets the cursor image to the specified cursor.
`void`	`setDropTarget(DropTarget dt)`	Associate a `DropTarget` with this component.
`void`	`setFocusable(boolean focusable)`	Sets the focusable state of this Component to the specified value.
`void`	`setFocusTraversalKeysEnabled(boolean focusTraversalKeysEnabled)`	Sets whether focus traversal keys are enabled for this Component.
`void`	`setIgnoreRepaint(boolean ignoreRepaint)`	Sets whether or not paint messages received from the operating system should be ignored.
`void`	`setLocale(Locale l)`	Sets the locale of this component.
`void`	`setLocation(int x, int y)`	Moves this component to a new location.
`void`	`setLocation(Point p)`	Moves this component to a new location.
`void`	`setMixingCutoutShape(Shape shape)`	Sets a 'mixing-cutout' shape for this lightweight component.
`void`	`setName(String name)`	Sets the name of the component to the specified string.
`void`	`setSize(int width, int height)`	Resizes this component so that it has width `width` and height `height`.
`void`	`setSize(Dimension d)`	Resizes this component so that it has width `d.width` and height `d.height`.
`void`	`show()`	Deprecated. As of JDK version 1.1, replaced by `setVisible(boolean)`.
`void`	`show(boolean b)`	Deprecated. As of JDK version 1.1, replaced by `setVisible(boolean)`.
`Dimension`	`size()`	Deprecated. As of JDK version 1.1, replaced by `getSize()`.
`String`	`toString()`	Returns a string representation of this component and its values.
`void`	`transferFocus()`	Transfers the focus to the next component, as though this Component were the focus owner.
`void`	`transferFocusBackward()`	Transfers the focus to the previous component, as though this Component were the focus owner.
`void`	`transferFocusUpCycle()`	Transfers the focus up one focus traversal cycle.

Methods declared in class Object

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

Modifier and Type	Method	Description
`protected Object`	`clone()`	Creates and returns a copy of this object.
`boolean`	`equals(Object obj)`	Indicates whether some other object is "equal to" this one.
`protected void`	`finalize()`	Deprecated, for removal: This API element is subject to removal in a future version. Finalization is deprecated and subject to removal in a future release.
`final Class<?>`	`getClass()`	Returns the runtime class of this `Object`.
`int`	`hashCode()`	Returns a hash code value for this object.
`final void`	`notify()`	Wakes up a single thread that is waiting on this object's monitor.
`final void`	`notifyAll()`	Wakes up all threads that are waiting on this object's monitor.
`final void`	`wait()`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
`final void`	`wait(long timeoutMillis)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
`final void`	`wait(long timeoutMillis, int nanos)`	Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

Field Details

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. If null, the UI uses a default cellRenderer.

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:

selectionRedirector

protected transient JTree.TreeSelectionRedirector selectionRedirector

Creates a new event and passed it off the selectionListeners.

cellEditor

protected transient TreeCellEditor cellEditor

Editor for the entries. Default is null (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 the Scrollable 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 means stopCellEditing 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 the expandedState.

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY

Bound property name for cellRenderer.

See Also:

TREE_MODEL_PROPERTY

public static final String TREE_MODEL_PROPERTY

Bound property name for treeModel.

See Also:

ROOT_VISIBLE_PROPERTY

public static final String ROOT_VISIBLE_PROPERTY

Bound property name for rootVisible.

See Also:

SHOWS_ROOT_HANDLES_PROPERTY

public static final String SHOWS_ROOT_HANDLES_PROPERTY

Bound property name for showsRootHandles.

See Also:

ROW_HEIGHT_PROPERTY

public static final String ROW_HEIGHT_PROPERTY

Bound property name for rowHeight.

See Also:

CELL_EDITOR_PROPERTY

public static final String CELL_EDITOR_PROPERTY

Bound property name for cellEditor.

See Also:

EDITABLE_PROPERTY

public static final String EDITABLE_PROPERTY

Bound property name for editable.

See Also:

LARGE_MODEL_PROPERTY

public static final String LARGE_MODEL_PROPERTY

Bound property name for largeModel.

See Also:

SELECTION_MODEL_PROPERTY

public static final String SELECTION_MODEL_PROPERTY

Bound property name for selectionModel.

See Also:

VISIBLE_ROW_COUNT_PROPERTY

public static final String VISIBLE_ROW_COUNT_PROPERTY

Bound property name for visibleRowCount.

See Also:

INVOKES_STOP_CELL_EDITING_PROPERTY

public static final String INVOKES_STOP_CELL_EDITING_PROPERTY

Bound property name for messagesStopCellEditing.

See Also:

SCROLLS_ON_EXPAND_PROPERTY

public static final String SCROLLS_ON_EXPAND_PROPERTY

Bound property name for scrollsOnExpand.

See Also:

TOGGLE_CLICK_COUNT_PROPERTY

public static final String TOGGLE_CLICK_COUNT_PROPERTY

Bound property name for toggleClickCount.

See Also:

LEAD_SELECTION_PATH_PROPERTY

public static final String LEAD_SELECTION_PATH_PROPERTY

Bound property name for leadSelectionPath.

Since:

1.3

See Also:

ANCHOR_SELECTION_PATH_PROPERTY

public static final String ANCHOR_SELECTION_PATH_PROPERTY

Bound property name for anchor selection path.

Since:

1.3

See Also:

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:

Constructor Details

JTree

public JTree()

Returns a JTree with a sample model. The default model used by the tree defines a leaf node as any node without children.

See Also:

JTree

public JTree(Object[] value)

Returns a JTree 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 of Objects

See Also:

JTree

public JTree(Vector<?> value)

Returns a JTree with each element of the specified Vector 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 - a Vector

See Also:

JTree

public JTree(Hashtable<?,?> value)

Returns a JTree created from a Hashtable which does not display with root. Each value-half of the key/value pairs in the HashTable becomes a child of the new root node. By default, the tree defines a leaf node as any node without children.

Parameters:

value - a Hashtable

See Also:

JTree

public JTree(TreeNode root)

Returns a JTree with the specified TreeNode as its root, which displays the root node. By default, the tree defines a leaf node as any node without children.

Parameters:

root - a TreeNode object

See Also:

JTree

public JTree(TreeNode root, boolean asksAllowsChildren)

Returns a JTree with the specified TreeNode as its root, which displays the root node and which decides whether a node is a leaf node in the specified manner.

Parameters:

root - a TreeNode object

asksAllowsChildren - if false, any node without children is a leaf node; if true, only nodes that do not allow children are leaf nodes

See Also:

JTree

@ConstructorProperties("model") public JTree(TreeModel newModel)

Returns an instance of JTree which displays the root node -- the tree is created using the specified data model.

Parameters:: newModel - the TreeModel to use as the data model

Method Details

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()

Creates and returns a sample TreeModel. Used primarily for beanbuilders to show something interesting.

Returns:: the default TreeModel

createTreeModel

protected static TreeModel createTreeModel(Object value)

Returns a TreeModel wrapping the specified object. If the object is:

an array of Objects,
a Hashtable, or
a Vector

then a new root node is created with each of the incoming objects as children. Otherwise, a new root is created with a value of "root".

Parameters:: value - the Object used as the foundation for the TreeModel
Returns:: a TreeModel wrapping the specified object

getUI

public TreeUI getUI()

Returns the L&F object that renders this component.

Overrides:: getUI in class JComponent
Returns:: the TreeUI object that renders this component

setUI

@BeanProperty(hidden=true, visualUpdate=true, description="The UI object that implements the Component's LookAndFeel.") public void setUI(TreeUI ui)

Sets the L&F object that renders this component.

This is a bound property.

Parameters:

ui - the TreeUI L&F object

See Also:

updateUI

public void updateUI()

Notification from the UIManager that the L&F has changed. Replaces the current UI object with the latest version from the UIManager.

Overrides:

updateUI in class JComponent

See Also:

getUIClassID

@BeanProperty(bound=false) public String getUIClassID()

Returns the name of the L&F class that renders this component.

Overrides:

getUIClassID in class JComponent

Returns:

the string "TreeUI"

See Also:

getCellRenderer

public TreeCellRenderer getCellRenderer()

Returns the current TreeCellRenderer that is rendering each cell.

Returns:: the TreeCellRenderer that is rendering each cell

setCellRenderer

@BeanProperty(description="The TreeCellRenderer that will be used to draw each cell.") public void setCellRenderer(TreeCellRenderer x)

Sets the TreeCellRenderer that will be used to draw each cell.

This is a bound property.

Parameters:: x - the TreeCellRenderer that is to render each cell

setEditable

@BeanProperty(description="Whether the tree is editable.") 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

@BeanProperty(description="The cell editor. A null value implies the tree cannot be edited.") public void setCellEditor(TreeCellEditor cellEditor)

Sets the cell editor. A null value implies that the tree cannot be edited. If this represents a change in the cellEditor, the propertyChange method is invoked on all listeners.

This is a bound property.

Parameters:: cellEditor - the TreeCellEditor to use

getCellEditor

public TreeCellEditor getCellEditor()

Returns the editor used to edit entries in the tree.

Returns:: the TreeCellEditor in use, or null if the tree cannot be edited

getModel

public TreeModel getModel()

Returns the TreeModel that is providing the data.

Returns:: the TreeModel that is providing the data

setModel

@BeanProperty(description="The TreeModel that will provide the data.") public void setModel(TreeModel newModel)

Sets the TreeModel that will provide the data.

This is a bound property.

Parameters:: newModel - the TreeModel 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:

setRootVisible

@BeanProperty(description="Whether or not the root node from the TreeModel is visible.") public void setRootVisible(boolean rootVisible)

Determines whether or not the root node from the TreeModel is visible.

This is a bound property.

Parameters:

rootVisible - true if the root node of the tree is to be displayed

See Also:

setShowsRootHandles

@BeanProperty(description="Whether the node handles are to be displayed.") public void setShowsRootHandles(boolean newValue)

Sets the value of the showsRootHandles property, which specifies whether the node handles should be displayed. The default value of this property depends on the constructor used to create the JTree. 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:

getShowsRootHandles

public boolean getShowsRootHandles()

Returns the value of the showsRootHandles property.

Returns:

the value of the showsRootHandles property

See Also:

setRowHeight

@BeanProperty(description="The height of each cell.") 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.

Returns:: the height of each row

isFixedRowHeight

@BeanProperty(bound=false) 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

@BeanProperty(description="Whether the UI should use a large model.") 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:

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:

setInvokesStopCellEditing

@BeanProperty(description="Determines what happens when editing is interrupted, selecting another node in the tree, a change in the tree's data, or some other means.") 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 to true 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 that stopCellEditing is invoked when editing is interrupted, and data is saved; false means that cancelCellEditing 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:

setScrollsOnExpand

@BeanProperty(description="Indicates if a node descendant should be scrolled when expanded.") public void setScrollsOnExpand(boolean newValue)

Sets the scrollsOnExpand property, which determines whether the tree might scroll to show previously hidden children. If this property is true (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

public boolean getScrollsOnExpand()

Returns the value of the scrollsOnExpand property.

Returns:: the value of the scrollsOnExpand property

setToggleClickCount

@BeanProperty(description="Number of clicks before a node will expand/collapse.") 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.

Parameters:: clickCount - the number of mouse clicks to get a node expanded or closed
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

@BeanProperty(description="Indicates whether changes to the selection should make the parent of the path visible.") public void setExpandsSelectedPaths(boolean newValue)

Configures the expandsSelectedPaths property. If true, any time the selection is changed, either via the TreeSelectionModel, or the cover methods provided by JTree, the TreePaths parents will be expanded to make them visible (visible meaning the parent path is expanded, not necessarily in the visible rectangle of the JTree). 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 for expandsSelectedPaths
Since:: 1.3

getExpandsSelectedPaths

public boolean getExpandsSelectedPaths()

Returns the expandsSelectedPaths property.

Returns:

true if selection changes result in the parent path being expanded

Since:

1.3

See Also:

setDragEnabled

@BeanProperty(bound=false, description="determines whether automatic drag handling is enabled") public void setDragEnabled(boolean b)

Turns on or off automatic drag handling. In order to enable automatic drag handling, this property should be set to true, and the tree's TransferHandler needs to be non-null. The default value of the dragEnabled property is false.

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 subclass BasicLookAndFeel) 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 to true 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's TransferHandler.

Parameters:

b - whether or not to enable automatic drag handling

Throws:

HeadlessException - if b is true and GraphicsEnvironment.isHeadless() returns true

Since:

1.4

See Also:

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:

setDropMode

public final void setDropMode(DropMode dropMode)

Sets the drop mode for this component. For backward compatibility, the default for this property is DropMode.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 or null

Since:

1.6

See Also:

getDropMode

public final DropMode getDropMode()

Returns the drop mode for this component.

Returns:

the drop mode for this component

Since:

1.6

See Also:

getDropLocation

@BeanProperty(bound=false) 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, or null 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 the TransferHandler's canImport 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:

isPathEditable

public boolean isPathEditable(TreePath path)

Returns isEditable. This is invoked from the UI before editing begins to ensure 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.

Parameters:

path - a TreePath identifying a node

Returns:

true if every parent node and the node itself is editable

See Also:

getToolTipText

public String getToolTipText(MouseEvent event)

Overrides JComponent's getToolTipText 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 the ToolTipManager. This can be done by invoking ToolTipManager.sharedInstance().registerComponent(tree). This is not done automatically!

Overrides:: getToolTipText in class JComponent
Parameters:: event - the MouseEvent that initiated the ToolTip display
Returns:: a string containing the tooltip or null if event 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 returns value.toString, ignoring all other arguments. To control the conversion, subclass this method and use any of the arguments you need.

Parameters:: value - the Object to convert to text; selected - true if the node is selected; expanded - true if the node is expanded; leaf - true if the node is a leaf node; row - an integer specifying the node's display row, where 0 is the first row in the display; hasFocus - true if the node has the focus
Returns:: the String representation of the node's value

getRowCount

@BeanProperty(bound=false) 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 if isRootVisible() is true. This returns 0 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), and getExpandsSelectedPaths is true it is exposed (made viewable).

Parameters:: path - the TreePath 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), and getExpandsSelectedPaths is true it is exposed (made viewable).

Parameters:: paths - an array of TreePath objects that specifies the nodes to select

setLeadSelectionPath

@BeanProperty(description="Lead selection path") public void setLeadSelectionPath(TreePath newPath)

Sets the path identifies as the lead. The lead may not be selected. The lead is not maintained by JTree, rather the UI will update it.

This is a bound property.

Parameters:: newPath - the new lead path
Since:: 1.3

setAnchorSelectionPath

@BeanProperty(description="Anchor selection path") public void setAnchorSelectionPath(TreePath newPath)

Sets the path identified as the anchor. The anchor is not maintained by JTree, 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 of rows is < 0 or >= getRowCount, it will be ignored. If none of the elements in rows are valid rows, the selection will be cleared. That is it will be as if clearSelection 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 specified TreePath to the current selection. If any component of the path isn't viewable, and getExpandsSelectedPaths 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 - the TreePath 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 and getExpandsSelectedPaths 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 of TreePath 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

@BeanProperty(bound=false) public Object getLastSelectedPathComponent()

Returns the last path component of the selected path. This is a convenience method for getSelectionModel().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:

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, or null 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, or null if nothing is currently selected

getSelectionRows

public int[] getSelectionRows()

Returns all of the currently selected rows. This method is simply forwarded to the TreeSelectionModel. If nothing is selected null or an empty array will be returned, based on the TreeSelectionModel implementation.

Returns:: an array of integers that identifies all currently selected rows where 0 is the first row in the display

getSelectionCount

@BeanProperty(bound=false) public int getSelectionCount()

Returns the number of nodes selected.

Returns:: the number of nodes selected

getMinSelectionRow

@BeanProperty(bound=false) 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

@BeanProperty(bound=false) 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

@BeanProperty(bound=false) 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 is null

isPathSelected

public boolean isPathSelected(TreePath path)

Returns true if the item identified by the path is currently selected.

Parameters:: path - a TreePath 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 an Enumeration of the descendants of the path parent that are currently expanded. If parent is not currently expanded, this will return null. If you expand/collapse nodes while iterating over the returned Enumeration 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 of parent, or null if parent is not currently expanded

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)

Returns true if the node identified by the path has ever been expanded.

Parameters:: path - a TreePath identifying a node
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 - the TreePath 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 - the TreePath 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 - the TreePath 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.

Parameters:: path - TreePath identifying a node
Returns:: true if the node is viewable, otherwise false

getPathBounds

public Rectangle getPathBounds(TreePath path)

Returns the Rectangle that the specified node will be drawn into. Returns null 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 - the TreePath identifying the node
Returns:: the Rectangle the node is drawn in, or null

getRowBounds

public Rectangle getRowBounds(int row)

Returns the Rectangle 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 this JTree is contained in a JScrollPane.

Parameters:: path - the TreePath 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 this JTree is contained in a JScrollPane.

Parameters:: row - an integer specifying the row to scroll, where 0 is the first row in the display

getPathForRow

@BeanProperty(bound=false) public TreePath getPathForRow(int row)

Returns the path for the specified row. If row is not visible, or a TreeUI has not been set, null is returned.

Parameters:: row - an integer specifying a row
Returns:: the TreePath to the specified node, null if row < 0 or row >= getRowCount()

getRowForPath

public int getRowForPath(TreePath path)

Returns the row that displays the node identified by the specified path.

Parameters:: path - the TreePath 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 - the TreePath 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 - the TreePath 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 margin; y - 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 margin

y - 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:

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, returns null, 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 margin

y - 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:

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 margin

y - 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:

isEditing

@BeanProperty(bound=false) public boolean isEditing()

Returns true if the tree is being edited. The item that is being edited can be obtained using getSelectionPath.

Returns:

true if the user is currently editing a node

See Also:

stopEditing

public boolean stopEditing()

Ends the current editing session. (The DefaultTreeCellEditor 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, use setInvokesStopCellEditing(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 the CellEditor does not allow editing for the specified item.

Parameters:: path - the TreePath identifying a node

getEditingPath

@BeanProperty(bound=false) public TreePath getEditingPath()

Returns the path to the element that is currently being edited.

Returns:: the TreePath for the node being edited

setSelectionModel

@BeanProperty(description="The tree's selection model.") public void setSelectionModel(TreeSelectionModel selectionModel)

Sets the tree's selection model. When a null value is specified an empty selectionModel is used, which does not allow selections.

This is a bound property.

Parameters:

selectionModel - the TreeSelectionModel to use, or null to disable selections

See Also:

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 to null, which forces an empty selection model to be used.

Returns:

the model for selections

See Also:

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 is 10, 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 with 0, 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 to getPathBetweenRows(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 range; index1 - 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 is

, and this method is invoked with -1, 20, then the specified indices bounds the viewable range, and this is treated as if invoked with 0, 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 to setSelectionInterval(y, x).

Parameters:: index0 - the first index in the range to select; index1 - 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 is 10, and this method is invoked with -1, 20, then the specified indices bounds the viewable range, and this is treated as if invoked with 0, 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 to addSelectionInterval(y, x).

Parameters:: index0 - the first index in the range to add to the selection; index1 - 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 is

, and this method is invoked with -1, 20, then the specified range bounds the viewable range, and this is treated as if invoked with 0, 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 to removeSelectionInterval(y, x).

Parameters:: index0 - the first row to remove from the selection; index1 - 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 - the TreePath 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 of TreePath objects that specifies the nodes to remove

removeSelectionRow

public void removeSelectionRow(int row)

Removes the row at the index row 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

@BeanProperty(bound=false) 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 for TreeExpansion 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 for TreeExpansion events.

Parameters:: tel - the TreeExpansionListener to remove

getTreeExpansionListeners

@BeanProperty(bound=false) public TreeExpansionListener[] getTreeExpansionListeners()

Returns an array of all the TreeExpansionListeners added to this JTree with addTreeExpansionListener().

Returns:: all of the TreeExpansionListeners added or an empty array if no listeners have been added
Since:: 1.4

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)

Adds a listener for TreeWillExpand events.

Parameters:: tel - a TreeWillExpandListener 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 for TreeWillExpand events.

Parameters:: tel - the TreeWillExpandListener to remove

getTreeWillExpandListeners

@BeanProperty(bound=false) public TreeWillExpandListener[] getTreeWillExpandListeners()

Returns an array of all the TreeWillExpandListeners added to this JTree with addTreeWillExpandListener().

Returns:: all of the TreeWillExpandListeners 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 the path parameter.

Parameters:

path - the TreePath indicating the node that was expanded

See Also:

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 the path parameter.

Parameters:

path - the TreePath indicating the node that was collapsed

See Also:

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 the path parameter.

Parameters:

path - the TreePath indicating the node that was expanded

Throws:

ExpandVetoException - if the expansion is prevented from occurring

See Also:

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 the path parameter.

Parameters:

path - the TreePath indicating the node that was expanded

Throws:

ExpandVetoException - if the collapse is prevented from occurring

See Also:

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

Adds a listener for TreeSelection events.

Parameters:: tsl - the TreeSelectionListener that will be notified when a node is selected or deselected (a "negative selection")

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)

Removes a TreeSelection listener.

Parameters:: tsl - the TreeSelectionListener to remove

getTreeSelectionListeners

@BeanProperty(bound=false) public TreeSelectionListener[] getTreeSelectionListeners()

Returns an array of all the TreeSelectionListeners added to this JTree with addTreeSelectionListener().

Returns:: all of the TreeSelectionListeners 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 - the TreeSelectionEvent to be fired; generated by the TreeSelectionModel when a node is selected or deselected

See Also:

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

@BeanProperty(description="The number of rows that are to be displayed.") 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 a JScrollPane, 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 a TreePath into a String, convertValueToText is used.

Parameters:: prefix - the string to test for a match; startingRow - the row for starting the search; bias - 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

@BeanProperty(bound=false) public Dimension getPreferredScrollableViewportSize()

Returns the preferred display size of a JTree. The height is determined from getVisibleRowCount and the width is the current preferred width.

Specified by:

getPreferredScrollableViewportSize in interface Scrollable

Returns:

a Dimension object containing the preferred size

See Also:

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 interface Scrollable

Parameters:

visibleRect - the view area visible within the viewport

orientation - either SwingConstants.VERTICAL or SwingConstants.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:

getScrollableBlockIncrement

public int getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)

Returns the amount for a block increment, which is the height or width of visibleRect, based on orientation.

Specified by:

getScrollableBlockIncrement in interface Scrollable

Parameters:

visibleRect - the view area visible within the viewport

orientation - either SwingConstants.VERTICAL or SwingConstants.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:

getScrollableTracksViewportWidth

@BeanProperty(bound=false) 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 interface Scrollable

Returns:

whether the tree should track the width of the viewport

See Also:

getScrollableTracksViewportHeight

@BeanProperty(bound=false) 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 interface Scrollable

Returns:

whether the tree should track the height of the viewport

See Also:

setExpandedState

protected void setExpandedState(TreePath path, boolean state)

Sets the expanded state of this JTree. If state is true, all parents of path and path are marked as expanded. If state is false, all parents of path are marked EXPANDED, but path itself is marked collapsed.

This will fail if a TreeWillExpandListener vetos it.

Parameters:: path - a TreePath identifying a node; state - if true, all parents of path and path are marked as expanded. Otherwise, all parents of path are marked EXPANDED, but path itself is marked collapsed.

getDescendantToggledPaths

protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)

Returns an Enumeration of TreePaths that have been expanded that are descendants of parent.

Parameters:: parent - a path
Returns:: the Enumeration of TreePaths

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)

Removes any descendants of the TreePaths in toRemove that have been expanded.

Parameters:: toRemove - an enumeration of the paths to remove; a value of null is ignored
Throws:: ClassCastException - if toRemove contains an element that is not a TreePath; null values are ignored

clearToggledPaths

protected void clearToggledPaths()

Clears the cache of toggled tree paths. This does NOT send out any TreeExpansionListener events.

createTreeModelListener

protected TreeModelListener createTreeModelListener()

Creates and returns an instance of TreeModelHandler. The returned object is responsible for updating the expanded state when the TreeModel changes.

For more information on what expanded state means, see the JTree description above.

Returns:: the instance of TreeModelHandler

removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)

Removes any paths in the selection that are descendants of path. If includePath is true and path is selected, it will be removed from the selection.

Parameters:: path - a path; includePath - is true and path 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 this JTree. 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 be null.

Overrides:: paramString in class JComponent
Returns:: a string representation of this JTree.

getAccessibleContext

@BeanProperty(bound=false) 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 interface Accessible
Overrides:: getAccessibleContext in class Component
Returns:: an AccessibleJTree that serves as the AccessibleContext of this JTree

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.