Класс JTree

javax.swing.JTree

Все реализованные интерфейсы:: 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

Элемент управления, который отображает набор иерархических данных в виде дерева. Документацию и примеры использования деревьев для решения конкретных задач можно найти в разделе Как использовать деревья учебника Java.

Конкретный узел дерева можно идентифицировать либо с помощью TreePath (объекта, который инкапсулирует узел и всех его предков), либо по его строке отображения, где в каждой строке области отображения показывается один узел. Развёрнутый узел — это нелистовой узел (определяемый тем, что TreeModel.isLeaf(node) возвращает false), дочерние узлы которого отображаются, когда все его предки развёрнуты. Свёрнутый узел скрывает дочерние узлы. Скрытый узел находится под свёрнутым предком. Все предки доступного для просмотра узла развёрнуты, но сам узел может отображаться или не отображаться. Отображаемый узел одновременно доступен для просмотра и находится в области отображения, где его можно видеть.

В следующих методах JTree слово «видимый» означает «отображаемый»:

isRootVisible()
setRootVisible()
scrollPathToVisible()
scrollRowToVisible()
getVisibleRowCount()
setVisibleRowCount()

В следующей группе методов JTree слово «видимый» означает «доступный для просмотра» (находящийся под развёрнутым родителем):

isVisible()
makeVisible()

Если вам нужно знать, когда изменяется выделение, реализуйте интерфейс TreeSelectionListener и добавьте экземпляр с помощью метода addTreeSelectionListener. Метод valueChanged будет вызван при изменении выделения; например, если пользователь дважды щёлкнет один и тот же узел, valueChanged будет вызван только один раз.

Если вам нужно обнаруживать события двойного щелчка или щелчки пользователя по узлу независимо от того, был ли он выделен, рекомендуем сделать следующее:

 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);

ПРИМЕЧАНИЕ: в этом примере получаются и путь, и строка, но вам нужно получить только то, что вас интересует.

Чтобы использовать JTree для отображения составных узлов (например, узлов, содержащих графический значок и текст), создайте подкласс TreeCellRenderer и используйте setCellRenderer(TreeCellRenderer), чтобы указать дереву использовать его. Для редактирования таких узлов создайте подкласс TreeCellEditor и используйте setCellEditor(TreeCellEditor).

Как и для всех классов JComponent, с помощью InputMap и ActionMap можно связать объект Action с объектом KeyStroke и выполнить действие при заданных условиях.

Предупреждение: Swing не является потокобезопасным. Дополнительную информацию см. в разделе Политика потоков Swing.

Предупреждение: сериализованные объекты этого класса не будут совместимы с будущими версиями Swing. Текущая поддержка сериализации предназначена для кратковременного хранения или RMI между приложениями, использующими одну и ту же версию Swing. Начиная с версии 1.4, в пакет java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с версии:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JTree.AccessibleJTree`	Этот класс реализует поддержку специальных возможностей для класса `JTree`.
`static final class`	`JTree.DropLocation`	Подкласс `TransferHandler.DropLocation`, представляющий место вставки для `JTree`.
`static class`	`JTree.DynamicUtilTreeNode`	`DynamicUtilTreeNode` может оборачивать векторы, хеш-таблицы, массивы и строки, а также при необходимости создавать соответствующие дочерние узлы дерева.
`protected static class`	`JTree.EmptySelectionModel`	`EmptySelectionModel` — это `TreeSelectionModel`, в котором нельзя ничего выбрать.
`protected class`	`JTree.TreeModelHandler`	Отслеживает модель и соответствующим образом обновляет `expandedState` при удалении или изменении узлов.
`protected class`	`JTree.TreeSelectionRedirector`	Создаёт новое `TreeSelectionEvent` с `JTree` в качестве источника и передаёт его всем слушателям.

Вложенные классы и интерфейсы, объявленные в классе JComponent

JComponent.AccessibleJComponent

Вложенные классы и интерфейсы, объявленные в классе Container

Container.AccessibleAWTContainer

Вложенные классы и интерфейсы, объявленные в классе Component

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

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final String`	`ANCHOR_SELECTION_PATH_PROPERTY`	Имя связанного свойства для пути привязки выделения.
`static final String`	`CELL_EDITOR_PROPERTY`	Имя связанного свойства для `cellEditor`.
`static final String`	`CELL_RENDERER_PROPERTY`	Имя связанного свойства для `cellRenderer`.
`protected TreeCellEditor`	`cellEditor`	Редактор записей.
`protected TreeCellRenderer`	`cellRenderer`	Ячейка, используемая для отрисовки узлов.
`protected boolean`	`editable`	Можно ли редактировать дерево?
`static final String`	`EDITABLE_PROPERTY`	Имя связанного свойства для `editable`.
`static final String`	`EXPANDS_SELECTED_PATHS_PROPERTY`	Имя связанного свойства для свойства раскрытия выбранных путей
`static final String`	`INVOKES_STOP_CELL_EDITING_PROPERTY`	Имя связанного свойства для `messagesStopCellEditing`.
`protected boolean`	`invokesStopCellEditing`	Если значение true, при остановке редактирования из-за изменения выделения, данных дерева или по другим причинам вызывается `stopCellEditing` и сохраняются изменения.
`static final String`	`LARGE_MODEL_PROPERTY`	Имя связанного свойства для `largeModel`.
`protected boolean`	`largeModel`	Является ли это дерево большой моделью?
`static final String`	`LEAD_SELECTION_PATH_PROPERTY`	Имя связанного свойства для `leadSelectionPath`.
`static final String`	`ROOT_VISIBLE_PROPERTY`	Имя связанного свойства для `rootVisible`.
`protected boolean`	`rootVisible`	Значение true, если отображается корневой узел, и false, если самыми верхними видимыми узлами являются его дочерние узлы.
`static final String`	`ROW_HEIGHT_PROPERTY`	Имя связанного свойства для `rowHeight`.
`protected int`	`rowHeight`	Высота каждой строки отображения.
`static final String`	`SCROLLS_ON_EXPAND_PROPERTY`	Имя связанного свойства для `scrollsOnExpand`.
`protected boolean`	`scrollsOnExpand`	Если значение true, при раскрытии узла выполняется прокрутка, чтобы показать как можно больше его потомков.
`static final String`	`SELECTION_MODEL_PROPERTY`	Имя связанного свойства для selectionModel.
`protected TreeSelectionModel`	`selectionModel`	Моделирует набор выбранных узлов в этом дереве.
`protected JTree.TreeSelectionRedirector`	`selectionRedirector`	Создаёт новое событие и передаёт его `selectionListeners`.
`static final String`	`SHOWS_ROOT_HANDLES_PROPERTY`	Имя связанного свойства для `showsRootHandles`.
`protected boolean`	`showsRootHandles`	Значение true, если маркеры отображаются на самом верхнем уровне дерева.
`static final String`	`TOGGLE_CLICK_COUNT_PROPERTY`	Имя связанного свойства для `toggleClickCount`.
`protected int`	`toggleClickCount`	Количество щелчков мышью, необходимое для раскрытия узла.
`static final String`	`TREE_MODEL_PROPERTY`	Имя связанного свойства для `treeModel`.
`protected TreeModel`	`treeModel`	Модель, определяющая дерево, отображаемое этим объектом.
`protected TreeModelListener`	`treeModelListener`	Обновляет `expandedState`.
`static final String`	`VISIBLE_ROW_COUNT_PROPERTY`	Имя связанного свойства для `visibleRowCount`.
`protected int`	`visibleRowCount`	Количество строк, отображаемых одновременно.

Поля, объявленные в классе JComponent

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

Поля, объявленные в классе Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе ImageObserver

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

Краткое описание конструкторов

Конструктор	Описание
`JTree()`	Возвращает `JTree` с примером модели.
`JTree(Object[] value)`	Возвращает `JTree`, каждый элемент указанного массива становится дочерним узлом нового корневого узла, который не отображается.
`JTree(Hashtable<?,?> value)`	Возвращает `JTree`, созданный на основе `Hashtable`, в котором корневой узел не отображается.
`JTree(Vector<?> value)`	Возвращает `JTree`, каждый элемент указанного `Vector` становится дочерним узлом нового корневого узла, который не отображается.
`JTree(TreeModel newModel)`	Возвращает экземпляр `JTree`, отображающий корневой узел; дерево создаётся с использованием указанной модели данных.
`JTree(TreeNode root)`	Возвращает `JTree` с указанным `TreeNode` в качестве корневого узла, который отображается.
`JTree(TreeNode root, boolean asksAllowsChildren)`	Возвращает `JTree` с указанным `TreeNode` в качестве корневого узла, который отображается; способ определения того, является ли узел листовым, задаётся указанным образом.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addSelectionInterval(int index0, int index1)`	Добавляет указанные строки (включительно) в выделение.
`void`	`addSelectionPath(TreePath path)`	Добавляет узел, идентифицированный указанным `TreePath`, в текущее выделение.
`void`	`addSelectionPaths(TreePath[] paths)`	Добавляет каждый путь из массива путей в текущее выделение.
`void`	`addSelectionRow(int row)`	Добавляет путь из указанной строки в текущее выделение.
`void`	`addSelectionRows(int[] rows)`	Добавляет пути из каждой указанной строки в текущее выделение.
`void`	`addTreeExpansionListener(TreeExpansionListener tel)`	Добавляет слушателя событий `TreeExpansion`.
`void`	`addTreeSelectionListener(TreeSelectionListener tsl)`	Добавляет слушателя событий `TreeSelection`.
`void`	`addTreeWillExpandListener(TreeWillExpandListener tel)`	Добавляет слушателя событий `TreeWillExpand`.
`void`	`cancelEditing()`	Отменяет текущий сеанс редактирования.
`void`	`clearSelection()`	Снимает выделение.
`protected void`	`clearToggledPaths()`	Очищает кэш переключённых путей дерева.
`void`	`collapsePath(TreePath path)`	Гарантирует, что узел, идентифицированный указанным путём, свёрнут и доступен для просмотра.
`void`	`collapseRow(int row)`	Гарантирует, что узел в указанной строке свёрнут.
`String`	`convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)`	Вызывается средствами визуализации для преобразования указанного значения в текст.
`protected static TreeModel`	`createTreeModel(Object value)`	Возвращает `TreeModel`, содержащий указанный объект.
`protected TreeModelListener`	`createTreeModelListener()`	Создаёт и возвращает экземпляр `TreeModelHandler`.
`void`	`expandPath(TreePath path)`	Гарантирует, что узел, идентифицированный указанным путём, развёрнут и доступен для просмотра.
`void`	`expandRow(int row)`	Гарантирует, что узел в указанной строке развёрнут и доступен для просмотра.
`void`	`fireTreeCollapsed(TreePath path)`	Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
`void`	`fireTreeExpanded(TreePath path)`	Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
`void`	`fireTreeWillCollapse(TreePath path)`	Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
`void`	`fireTreeWillExpand(TreePath path)`	Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
`protected void`	`fireValueChanged(TreeSelectionEvent e)`	Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим JTree.
`TreePath`	`getAnchorSelectionPath()`	Возвращает путь, определённый как якорный.
`TreeCellEditor`	`getCellEditor()`	Возвращает редактор, используемый для редактирования записей в дереве.
`TreeCellRenderer`	`getCellRenderer()`	Возвращает текущий `TreeCellRenderer`, выполняющий визуализацию каждой ячейки.
`TreePath`	`getClosestPathForLocation(int x, int y)`	Возвращает путь к узлу, ближайшему к точке x,y.
`int`	`getClosestRowForLocation(int x, int y)`	Возвращает строку узла, ближайшего к точке x,y.
`protected static TreeModel`	`getDefaultTreeModel()`	Создаёт и возвращает образец `TreeModel`.
`protected Enumeration<TreePath>`	`getDescendantToggledPaths(TreePath parent)`	Возвращает `Enumeration` из `TreePaths`, которые были развёрнуты и являются потомками `parent`.
`boolean`	`getDragEnabled()`	Возвращает сведения о том, включена ли автоматическая обработка перетаскивания.
`final JTree.DropLocation`	`getDropLocation()`	Возвращает местоположение, которое компонент должен визуально обозначать как место сброса во время операции DnD над компонентом, или `null`, если в данный момент не следует показывать никакое местоположение.
`final DropMode`	`getDropMode()`	Возвращает режим сброса для этого компонента.
`TreePath`	`getEditingPath()`	Возвращает путь к элементу, который редактируется в данный момент.
`Enumeration<TreePath>`	`getExpandedDescendants(TreePath parent)`	Возвращает `Enumeration` потомков пути `parent`, которые в данный момент развёрнуты.
`boolean`	`getExpandsSelectedPaths()`	Возвращает свойство `expandsSelectedPaths`.
`boolean`	`getInvokesStopCellEditing()`	Возвращает индикатор, определяющий, что происходит при прерывании редактирования.
`Object`	`getLastSelectedPathComponent()`	Возвращает последний компонент пути выбранного пути.
`TreePath`	`getLeadSelectionPath()`	Возвращает путь, определённый как ведущий.
`int`	`getLeadSelectionRow()`	Возвращает индекс строки, соответствующей ведущему пути.
`int`	`getMaxSelectionRow()`	Возвращает наибольший индекс выбранной строки.
`int`	`getMinSelectionRow()`	Возвращает наименьший индекс выбранной строки.
`TreeModel`	`getModel()`	Возвращает `TreeModel`, предоставляющую данные.
`TreePath`	`getNextMatch(String prefix, int startingRow, Position.Bias bias)`	Возвращает TreePath к следующему элементу дерева, начинающемуся с заданного префикса.
`protected TreePath[]`	`getPathBetweenRows(int index0, int index1)`	Возвращает пути (включительно) между указанными строками.
`Rectangle`	`getPathBounds(TreePath path)`	Возвращает `Rectangle`, в который будет отрисован указанный узел.
`TreePath`	`getPathForLocation(int x, int y)`	Возвращает путь к узлу в указанном месте.
`TreePath`	`getPathForRow(int row)`	Возвращает путь для указанной строки.
`Dimension`	`getPreferredScrollableViewportSize()`	Возвращает предпочтительный размер отображения `JTree`.
`Rectangle`	`getRowBounds(int row)`	Возвращает `Rectangle`, в котором отрисован узел из указанной строки.
`int`	`getRowCount()`	Возвращает количество видимых узлов.
`int`	`getRowForLocation(int x, int y)`	Возвращает строку для указанного местоположения.
`int`	`getRowForPath(TreePath path)`	Возвращает строку, в которой отображается узел, идентифицированный указанным путём.
`int`	`getRowHeight()`	Возвращает высоту каждой строки.
`int`	`getScrollableBlockIncrement(Rectangle visibleRect, int orientation, int direction)`	Возвращает величину шага прокрутки, равную высоте или ширине `visibleRect` и зависящую от `orientation`.
`boolean`	`getScrollableTracksViewportHeight()`	Возвращает false, указывая, что высота области просмотра не определяет высоту таблицы, кроме случая, когда предпочтительная высота дерева меньше высоты области просмотра.
`boolean`	`getScrollableTracksViewportWidth()`	Возвращает false, указывая, что ширина области просмотра не определяет ширину таблицы, кроме случая, когда предпочтительная ширина дерева меньше ширины области просмотра.
`int`	`getScrollableUnitIncrement(Rectangle visibleRect, int orientation, int direction)`	Возвращает величину шага прокрутки.
`boolean`	`getScrollsOnExpand()`	Возвращает значение свойства `scrollsOnExpand`.
`int`	`getSelectionCount()`	Возвращает количество выбранных узлов.
`TreeSelectionModel`	`getSelectionModel()`	Возвращает модель выделения.
`TreePath`	`getSelectionPath()`	Возвращает путь к первому выбранному узлу.
`TreePath[]`	`getSelectionPaths()`	Возвращает пути ко всем выбранным значениям.
`int[]`	`getSelectionRows()`	Возвращает все строки, выбранные в данный момент.
`boolean`	`getShowsRootHandles()`	Возвращает значение свойства `showsRootHandles`.
`int`	`getToggleClickCount()`	Возвращает количество щелчков мышью, необходимое для разворачивания или сворачивания узла.
`String`	`getToolTipText(MouseEvent event)`	Переопределяет метод `getToolTipText` класса `JComponent`, чтобы можно было использовать подсказки средства визуализации, если для него задан текст.
`TreeExpansionListener[]`	`getTreeExpansionListeners()`	Возвращает массив всех `TreeExpansionListener`, добавленных в этот JTree с помощью addTreeExpansionListener().
`TreeSelectionListener[]`	`getTreeSelectionListeners()`	Возвращает массив всех `TreeSelectionListener`, добавленных в этот JTree с помощью addTreeSelectionListener().
`TreeWillExpandListener[]`	`getTreeWillExpandListeners()`	Возвращает массив всех `TreeWillExpandListener`, добавленных в этот JTree с помощью addTreeWillExpandListener().
`TreeUI`	`getUI()`	Возвращает объект L&F, выполняющий визуализацию этого компонента.
`String`	`getUIClassID()`	Возвращает имя класса L&F, выполняющего визуализацию этого компонента.
`int`	`getVisibleRowCount()`	Возвращает количество строк, отображаемых в области вывода.
`boolean`	`hasBeenExpanded(TreePath path)`	Возвращает true, если узел, идентифицированный путём, когда-либо разворачивался.
`boolean`	`isCollapsed(int row)`	Возвращает true, если узел в указанной строке отображения свёрнут.
`boolean`	`isCollapsed(TreePath path)`	Возвращает true, если значение, идентифицированное путём, в данный момент свёрнуто; возвращает false, если какое-либо из значений в пути в данный момент не отображается.
`boolean`	`isEditable()`	Возвращает true, если дерево доступно для редактирования.
`boolean`	`isEditing()`	Возвращает true, если дерево редактируется.
`boolean`	`isExpanded(int row)`	Возвращает true, если узел в указанной строке отображения в данный момент развёрнут.
`boolean`	`isExpanded(TreePath path)`	Возвращает true, если узел, идентифицированный путём, в данный момент развёрнут,
`boolean`	`isFixedRowHeight()`	Возвращает true, если высота каждой строки отображения имеет фиксированный размер.
`boolean`	`isLargeModel()`	Возвращает true, если дерево настроено для большой модели.
`boolean`	`isPathEditable(TreePath path)`	Возвращает `isEditable`.
`boolean`	`isPathSelected(TreePath path)`	Возвращает true, если элемент, идентифицированный путём, в данный момент выбран.
`boolean`	`isRootVisible()`	Возвращает true, если корневой узел дерева отображается.
`boolean`	`isRowSelected(int row)`	Возвращает true, если узел, идентифицированный строкой, выбран.
`boolean`	`isSelectionEmpty()`	Возвращает true, если выделение в данный момент пусто.
`boolean`	`isVisible(TreePath path)`	Возвращает true, если значение, идентифицированное путём, в данный момент доступно для просмотра, то есть является корневым либо все его родительские узлы развёрнуты.
`void`	`makeVisible(TreePath path)`	Гарантирует, что узел, идентифицированный путём, в данный момент доступен для просмотра.
`protected String`	`paramString()`	Возвращает строковое представление этого `JTree`.
`protected boolean`	`removeDescendantSelectedPaths(TreePath path, boolean includePath)`	Удаляет из выделения все пути, являющиеся потомками `path`.
`protected void`	`removeDescendantToggledPaths(Enumeration<TreePath> toRemove)`	Удаляет все развёрнутые потомки `TreePaths` в `toRemove`.
`void`	`removeSelectionInterval(int index0, int index1)`	Удаляет указанные строки (включительно) из выделения.
`void`	`removeSelectionPath(TreePath path)`	Удаляет узел, идентифицированный указанным путём, из текущего выделения.
`void`	`removeSelectionPaths(TreePath[] paths)`	Удаляет узлы, идентифицированные указанными путями, из текущего выделения.
`void`	`removeSelectionRow(int row)`	Удаляет строку с индексом `row` из текущего выделения.
`void`	`removeSelectionRows(int[] rows)`	Снимает выделение со строк, выбранных для каждой из указанных строк.
`void`	`removeTreeExpansionListener(TreeExpansionListener tel)`	Удаляет слушателя событий `TreeExpansion`.
`void`	`removeTreeSelectionListener(TreeSelectionListener tsl)`	Удаляет слушателя `TreeSelection`.
`void`	`removeTreeWillExpandListener(TreeWillExpandListener tel)`	Удаляет слушателя событий `TreeWillExpand`.
`void`	`scrollPathToVisible(TreePath path)`	Гарантирует, что все компоненты пути в path развёрнуты (кроме последнего компонента пути), и прокручивает содержимое так, чтобы отображался узел, идентифицированный этим путём.
`void`	`scrollRowToVisible(int row)`	Прокручивает элемент, идентифицированный строкой, до его отображения.
`void`	`setAnchorSelectionPath(TreePath newPath)`	Задаёт путь, определённый как якорный.
`void`	`setCellEditor(TreeCellEditor cellEditor)`	Задаёт редактор ячеек.
`void`	`setCellRenderer(TreeCellRenderer x)`	Задаёт `TreeCellRenderer`, который будет использоваться для отрисовки каждой ячейки.
`void`	`setDragEnabled(boolean b)`	Включает или отключает автоматическую обработку перетаскивания.
`final void`	`setDropMode(DropMode dropMode)`	Задаёт режим сброса для этого компонента.
`void`	`setEditable(boolean flag)`	Определяет, доступно ли дерево для редактирования.
`protected void`	`setExpandedState(TreePath path, boolean state)`	Задаёт состояние развёрнутости этого `JTree`.
`void`	`setExpandsSelectedPaths(boolean newValue)`	Настраивает свойство `expandsSelectedPaths`.
`void`	`setInvokesStopCellEditing(boolean newValue)`	Определяет, что происходит при прерывании редактирования из-за выбора другого узла дерева, изменения данных дерева или по иной причине.
`void`	`setLargeModel(boolean newValue)`	Указывает, следует ли пользовательскому интерфейсу использовать большую модель.
`void`	`setLeadSelectionPath(TreePath newPath)`	Задаёт путь, определённый как ведущий.
`void`	`setModel(TreeModel newModel)`	Задаёт `TreeModel`, который будет предоставлять данные.
`void`	`setRootVisible(boolean rootVisible)`	Определяет, виден ли корневой узел из `TreeModel`.
`void`	`setRowHeight(int rowHeight)`	Задаёт высоту каждой ячейки в пикселях.
`void`	`setScrollsOnExpand(boolean newValue)`	Задаёт свойство `scrollsOnExpand`, определяющее, может ли дерево прокручиваться для отображения ранее скрытых дочерних узлов.
`void`	`setSelectionInterval(int index0, int index1)`	Выбирает строки в указанном интервале (включительно).
`void`	`setSelectionModel(TreeSelectionModel selectionModel)`	Задаёт модель выделения дерева.
`void`	`setSelectionPath(TreePath path)`	Выбирает узел, идентифицированный указанным путём.
`void`	`setSelectionPaths(TreePath[] paths)`	Выбирает узлы, идентифицированные указанным массивом путей.
`void`	`setSelectionRow(int row)`	Выбирает узел в указанной строке области отображения.
`void`	`setSelectionRows(int[] rows)`	Выбирает узлы, соответствующие каждой из указанных строк области отображения.
`void`	`setShowsRootHandles(boolean newValue)`	Задаёт значение свойства `showsRootHandles`, определяющего, следует ли отображать маркеры узлов.
`void`	`setToggleClickCount(int clickCount)`	Задаёт количество щелчков мышью, после которого узел будет развёрнут или свёрнут.
`void`	`setUI(TreeUI ui)`	Задаёт объект L&F, выполняющий визуализацию этого компонента.
`void`	`setVisibleRowCount(int newCount)`	Задаёт количество строк для отображения.
`void`	`startEditingAtPath(TreePath path)`	Выбирает узел, идентифицированный указанным путём, и начинает редактирование.
`boolean`	`stopEditing()`	Завершает текущий сеанс редактирования.
`void`	`treeDidChange()`	Вызывается, когда дерево изменилось настолько, что необходимо изменить размеры границ, но недостаточно для удаления набора развёрнутых узлов (например, узлы были развёрнуты или свёрнуты либо в дерево были вставлены узлы).
`void`	`updateUI()`	Уведомление от `UIManager` об изменении L&F.

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе 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

Методы, объявленные в классе Object

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

Подробное описание полей

treeModel

protected transient TreeModel treeModel

Модель, определяющая дерево, отображаемое этим объектом.

selectionModel

protected transient TreeSelectionModel selectionModel

Модель набора выбранных узлов в этом дереве.

rootVisible

protected boolean rootVisible

Значение true означает, что корневой узел отображается; false — что его дочерние узлы являются узлами верхнего видимого уровня.

cellRenderer

protected transient TreeCellRenderer cellRenderer

Компонент для отображения узлов. Если null, интерфейс использует стандартный cellRenderer.

rowHeight

protected int rowHeight

Высота каждой отображаемой строки. Если это значение меньше или равно 0, высоту каждой строки определяет средство отображения.

showsRootHandles

protected boolean showsRootHandles

Значение true означает, что маркеры отображаются на верхнем уровне дерева.

Маркер — это небольшой значок рядом с узлом, который позволяет пользователю одним щелчком развернуть или свернуть узел. Обычно для узла, который можно развернуть, отображается знак плюс (+), а для узла, который можно свернуть, — знак минус (-). Для узлов ниже верхнего уровня маркеры отображаются всегда.

Если настройка rootVisible указывает, что корневой узел нужно отображать, то он будет единственным узлом верхнего уровня. Если корневой узел не отображается, все его дочерние узлы находятся на верхнем уровне дерева. Для узлов, не относящихся к верхнему уровню, маркеры отображаются всегда.

Если корневой узел не виден, обычно рекомендуется задать этому значению true. В противном случае дерево будет выглядеть как обычный список, и пользователи могут не понять, что «элементы списка» на самом деле являются узлами дерева.

См. также:

selectionRedirector

protected transient JTree.TreeSelectionRedirector selectionRedirector

Создает новое событие и передает его в selectionListeners.

cellEditor

protected transient TreeCellEditor cellEditor

Редактор элементов. По умолчанию — null (дерево нельзя редактировать).

editable

protected boolean editable

Можно ли редактировать дерево? По умолчанию — false.

largeModel

protected boolean largeModel

Является ли это дерево большой моделью? Это настройка оптимизации кода. Большую модель можно использовать, если высота ячеек одинакова для всех узлов. В этом случае интерфейс будет кэшировать очень мало данных и вместо этого постоянно обращаться к модели. Если большая модель не используется, интерфейс кэширует большую часть данных, что позволяет сократить количество вызовов методов модели.

Это значение является лишь рекомендацией для интерфейса. Не все интерфейсы будут его учитывать. Значение по умолчанию — false.

visibleRowCount

protected int visibleRowCount

Количество строк, отображаемых одновременно. Это значение используется интерфейсом Scrollable. Оно определяет предпочтительный размер области отображения.

invokesStopCellEditing

protected boolean invokesStopCellEditing

Если значение true, то при завершении редактирования из-за изменения выбора, данных дерева или по другим причинам вызывается stopCellEditing, и изменения сохраняются. Если значение false, вызывается cancelCellEditing, и изменения отбрасываются. По умолчанию — false.

scrollsOnExpand

protected boolean scrollsOnExpand

Если значение true, при разворачивании узла прокрутка выполняется так, чтобы показать как можно больше его потомков.

toggleClickCount

protected int toggleClickCount

Количество щелчков мышью, необходимых для разворачивания узла.

treeModelListener

protected transient TreeModelListener treeModelListener

Обновляет expandedState.

CELL_RENDERER_PROPERTY

public static final String CELL_RENDERER_PROPERTY

Имя связанного свойства для cellRenderer.

См. также:

TREE_MODEL_PROPERTY

public static final String TREE_MODEL_PROPERTY

Имя связанного свойства для treeModel.

См. также:

ROOT_VISIBLE_PROPERTY

public static final String ROOT_VISIBLE_PROPERTY

Имя связанного свойства для rootVisible.

См. также:

SHOWS_ROOT_HANDLES_PROPERTY

public static final String SHOWS_ROOT_HANDLES_PROPERTY

Имя связанного свойства для showsRootHandles.

См. также:

ROW_HEIGHT_PROPERTY

public static final String ROW_HEIGHT_PROPERTY

Имя связанного свойства для rowHeight.

См. также:

CELL_EDITOR_PROPERTY

public static final String CELL_EDITOR_PROPERTY

Имя связанного свойства для cellEditor.

См. также:

EDITABLE_PROPERTY

public static final String EDITABLE_PROPERTY

Имя связанного свойства для editable.

См. также:

LARGE_MODEL_PROPERTY

public static final String LARGE_MODEL_PROPERTY

Имя связанного свойства для largeModel.

См. также:

SELECTION_MODEL_PROPERTY

public static final String SELECTION_MODEL_PROPERTY

Имя связанного свойства для selectionModel.

См. также:

VISIBLE_ROW_COUNT_PROPERTY

public static final String VISIBLE_ROW_COUNT_PROPERTY

Имя связанного свойства для visibleRowCount.

См. также:

INVOKES_STOP_CELL_EDITING_PROPERTY

public static final String INVOKES_STOP_CELL_EDITING_PROPERTY

Имя связанного свойства для messagesStopCellEditing.

См. также:

SCROLLS_ON_EXPAND_PROPERTY

public static final String SCROLLS_ON_EXPAND_PROPERTY

Имя связанного свойства для scrollsOnExpand.

См. также:

TOGGLE_CLICK_COUNT_PROPERTY

public static final String TOGGLE_CLICK_COUNT_PROPERTY

Имя связанного свойства для toggleClickCount.

См. также:

LEAD_SELECTION_PATH_PROPERTY

public static final String LEAD_SELECTION_PATH_PROPERTY

Имя связанного свойства для leadSelectionPath.

Начиная с:

1.3

См. также:

ANCHOR_SELECTION_PATH_PROPERTY

public static final String ANCHOR_SELECTION_PATH_PROPERTY

Имя связанного свойства для пути привязки выбора.

Начиная с:

1.3

См. также:

EXPANDS_SELECTED_PATHS_PROPERTY

public static final String EXPANDS_SELECTED_PATHS_PROPERTY

Имя связанного свойства для свойства разворачивания выбранных путей

Начиная с:

1.3

См. также:

Подробное описание конструкторов

JTree

public JTree()

Возвращает JTree с демонстрационной моделью. Модель по умолчанию, используемая деревом, определяет листовой узел как любой узел без дочерних узлов.

См. также:

JTree

public JTree(Object[] value)

Возвращает JTree, в котором каждый элемент указанного массива является дочерним узлом нового корневого узла, который не отображается. По умолчанию дерево определяет листовой узел как любой узел без дочерних узлов.

Параметры:

value — массив Objectов

См. также:

JTree

public JTree(Vector<?> value)

Возвращает JTree, в котором каждый элемент указанного Vector является дочерним узлом нового корневого узла, который не отображается. По умолчанию дерево определяет листовой узел как любой узел без дочерних узлов.

Параметры:

value — Vector

См. также:

JTree

public JTree(Hashtable<?,?> value)

Возвращает JTree, созданное из Hashtable, которое отображается без корневого узла. Каждое значение из пары ключ/значение в HashTable становится дочерним узлом нового корневого узла. По умолчанию дерево определяет листовой узел как любой узел без дочерних узлов.

Параметры:

value — Hashtable

См. также:

JTree

public JTree(TreeNode root)

Возвращает JTree, у которого указанный TreeNode является корневым узлом и отображается. По умолчанию дерево определяет листовой узел как любой узел без дочерних узлов.

Параметры:

root — объект TreeNode

См. также:

JTree

public JTree(TreeNode root, boolean asksAllowsChildren)

Возвращает JTree, у которого указанный TreeNode является корневым узлом и отображается; способ определения листового узла задается указанным параметром.

Параметры:

root — объект TreeNode

asksAllowsChildren — если значение false, любой узел без дочерних узлов является листовым; если true, листовыми являются только узлы, не допускающие дочерних узлов

См. также:

JTree

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

Возвращает экземпляр JTree, отображающий корневой узел; дерево создается с использованием указанной модели данных.

Параметры:: newModel — TreeModel, используемая в качестве модели данных

Подробное описание методов

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()

Создает и возвращает демонстрационную TreeModel. Используется главным образом разработчиками компонентов, чтобы показать что-нибудь интересное.

Возвращает:: модель TreeModel по умолчанию

createTreeModel

protected static TreeModel createTreeModel(Object value)

Возвращает TreeModel, содержащую указанный объект. Если объект является:

массивом Objectов,
объектом Hashtable или
объектом Vector,

то создается новый корневой узел, дочерними узлами которого становятся все переданные объекты. В противном случае создается новый корневой узел со значением "root".

Параметры:: value — Object, используемый в качестве основы для TreeModel
Возвращает:: TreeModel, содержащую указанный объект

getUI

public TreeUI getUI()

Возвращает объект оформления, который отображает этот компонент.

Переопределяет:: getUI в классе JComponent
Возвращает:: объект TreeUI, который отображает этот компонент

setUI

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

Устанавливает объект оформления, который отображает этот компонент.

Это связанное свойство.

Параметры:

ui — новый объект оформления TreeUI

См. также:

updateUI

public void updateUI()

Уведомление от UIManager об изменении оформления. Заменяет текущий объект пользовательского интерфейса последней версией из UIManager.

Переопределяет:

updateUI в классе JComponent

См. также:

getUIClassID

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

Возвращает имя класса оформления, который отображает этот компонент.

Переопределяет:

getUIClassID в классе JComponent

Возвращает:

строку "TreeUI"

См. также:

getCellRenderer

public TreeCellRenderer getCellRenderer()

Возвращает текущий TreeCellRenderer, который отображает каждую ячейку.

Возвращает:: TreeCellRenderer, который отображает каждую ячейку

setCellRenderer

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

Задает TreeCellRenderer, который будет использоваться для отображения каждой ячейки.

Это связанное свойство.

Параметры:: x — TreeCellRenderer, предназначенный для отображения каждой ячейки

setEditable

@BeanProperty(description="Whether the tree is editable.") public void setEditable(boolean flag)

Определяет, можно ли редактировать дерево. Если новое значение отличается от текущего, генерируется событие об изменении свойства.

Это связанное свойство.

Параметры:: flag — логическое значение: true, если дерево можно редактировать

isEditable

public boolean isEditable()

Возвращает true, если дерево можно редактировать.

Возвращает:: true, если дерево можно редактировать

setCellEditor

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

Задает редактор ячеек. Значение null означает, что дерево нельзя редактировать. Если это приводит к изменению cellEditor, для всех слушателей вызывается метод propertyChange.

Это связанное свойство.

Параметры:: cellEditor — используемый TreeCellEditor

getCellEditor

public TreeCellEditor getCellEditor()

Возвращает редактор, используемый для редактирования элементов дерева.

Возвращает:: используемый TreeCellEditor или null, если дерево нельзя редактировать

getModel

public TreeModel getModel()

Возвращает TreeModel, предоставляющую данные.

Возвращает:: TreeModel, предоставляющую данные

setModel

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

Задает TreeModel, которая будет предоставлять данные.

Это связанное свойство.

Параметры:: newModel — TreeModel, которая будет предоставлять данные

isRootVisible

public boolean isRootVisible()

Возвращает true, если корневой узел дерева отображается.

Возвращает:

true, если корневой узел дерева отображается

См. также:

setRootVisible

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

Определяет, будет ли виден корневой узел из TreeModel.

Это связанное свойство.

Параметры:

rootVisible — true, если корневой узел дерева нужно отображать

См. также:

setShowsRootHandles

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

Задает значение свойства showsRootHandles, определяющего, нужно ли отображать маркеры узлов. Значение этого свойства по умолчанию зависит от конструктора, использованного для создания JTree. Некоторые варианты оформления могут не поддерживать маркеры и будут игнорировать это свойство.

Это связанное свойство.

Параметры:

newValue — true, если маркеры корневого уровня нужно отображать; в противном случае — false

См. также:

getShowsRootHandles

public boolean getShowsRootHandles()

Возвращает значение свойства showsRootHandles.

Возвращает:

значение свойства showsRootHandles

См. также:

setRowHeight

@BeanProperty(description="The height of each cell.") public void setRowHeight(int rowHeight)

Задает высоту каждой ячейки в пикселях. Если указанное значение меньше или равно нулю, текущему средству отображения отправляется запрос на получение высоты каждой строки.

Это связанное свойство.

Параметры:: rowHeight — высота каждой ячейки в пикселях

getRowHeight

public int getRowHeight()

Возвращает высоту каждой строки. Если возвращаемое значение меньше или равно 0, высоту каждой строки определяет средство отображения.

Возвращает:: высоту каждой строки

isFixedRowHeight

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

Возвращает true, если высота каждой отображаемой строки имеет фиксированное значение.

Возвращает:: true, если высота каждой строки имеет фиксированное значение

setLargeModel

@BeanProperty(description="Whether the UI should use a large model.") public void setLargeModel(boolean newValue)

Указывает, следует ли интерфейсу использовать большую модель. (Эта возможность реализована не во всех интерфейсах.) Генерирует событие изменения свойства LARGE_MODEL_PROPERTY.

Это связанное свойство.

Параметры:

newValue — true, чтобы рекомендовать интерфейсу использовать большую модель

См. также:

isLargeModel

public boolean isLargeModel()

Возвращает true, если дерево настроено для использования большой модели.

Возвращает:

true, если рекомендуется использовать большую модель

См. также:

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)

Определяет, что происходит при прерывании редактирования из-за выбора другого узла дерева, изменения данных дерева или по другой причине. Если для этого свойства задано значение true, изменения автоматически сохраняются при прерывании редактирования.

Генерирует событие изменения свойства INVOKES_STOP_CELL_EDITING_PROPERTY.

Параметры:: newValue — значение true означает, что при прерывании редактирования вызывается stopCellEditing и данные сохраняются; значение false означает, что вызывается cancelCellEditing и изменения теряются

getInvokesStopCellEditing

public boolean getInvokesStopCellEditing()

Возвращает индикатор, определяющий, что происходит при прерывании редактирования.

Возвращает:

индикатор, определяющий, что происходит при прерывании редактирования

См. также:

setScrollsOnExpand

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

Задает свойство scrollsOnExpand, определяющее, может ли дерево прокручиваться для отображения ранее скрытых дочерних узлов. Если для этого свойства задано значение true (по умолчанию), при разворачивании узла дерево может прокручиваться, чтобы отобразить максимально возможное количество его потомков. В некоторых вариантах оформления при разворачивании дерева прокрутка может не требоваться; такие варианты оформления будут игнорировать это свойство.

Это связанное свойство.

Параметры:

newValue — false, чтобы отключить прокрутку при разворачивании; true, чтобы включить ее

См. также:

getScrollsOnExpand

public boolean getScrollsOnExpand()

Возвращает значение свойства scrollsOnExpand.

Возвращает:: значение свойства scrollsOnExpand

setToggleClickCount

@BeanProperty(description="Number of clicks before a node will expand/collapse.") public void setToggleClickCount(int clickCount)

Задает число щелчков мышью, после которого узел будет развернут или свернут. Значение по умолчанию — два.

Это связанное свойство.

Параметры:: clickCount — число щелчков мышью, необходимых для разворачивания или сворачивания узла
Начиная с версии:: 1.3

getToggleClickCount

public int getToggleClickCount()

Возвращает число щелчков мышью, необходимых для разворачивания или сворачивания узла.

Возвращает:: число щелчков мышью, необходимых для разворачивания узла
Начиная с версии:: 1.3

setExpandsSelectedPaths

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

Настраивает свойство expandsSelectedPaths. Если значение равно true, при каждом изменении выделения — будь то с помощью TreeSelectionModel или методов-оберток, предоставленных JTree, — родительские узлы TreePath будут развернуты, чтобы стать видимыми (видимость означает, что родительский путь развернут, а не обязательно находится в видимой области JTree). Если значение равно false, при изменении выделения родительский узел не становится видимым (все его родительские узлы не разворачиваются). Это полезно, если требуется, чтобы модель выделения содержала пути, которые не всегда видимы (все родительские узлы развернуты).

Это связанное свойство.

Параметры:: newValue — новое значение свойства expandsSelectedPaths
Начиная с версии:: 1.3

getExpandsSelectedPaths

public boolean getExpandsSelectedPaths()

Возвращает значение свойства expandsSelectedPaths.

Возвращает:

true, если при изменении выделения родительский путь разворачивается

Начиная с версии:

1.3

См. также:

setDragEnabled

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

Включает или отключает автоматическую обработку перетаскивания. Чтобы включить автоматическую обработку перетаскивания, для этого свойства необходимо задать значение true, а для TransferHandler дерева должно быть задано значение non-null. Значение по умолчанию свойства dragEnabled — false.

За соблюдение этого свойства и распознавание жеста перетаскивания пользователя отвечает реализация оформления и, в частности, TreeUI дерева. Когда автоматическая обработка перетаскивания включена, большинство оформлений (в том числе подклассы BasicLookAndFeel) начинают операцию перетаскивания, когда пользователь нажимает кнопку мыши над элементом, а затем перемещает мышь на несколько пикселей. Поэтому установка для этого свойства значения true может незаметно повлиять на поведение выделения.

Если используется оформление, которое игнорирует это свойство, операцию перетаскивания все равно можно начать, вызвав exportAsDrag для TransferHandler дерева.

Параметры:

b — следует ли включить автоматическую обработку перетаскивания

Вызывает исключение:

HeadlessException — если b имеет значение true, а GraphicsEnvironment.isHeadless() возвращает true

Начиная с версии:

1.4

См. также:

getDragEnabled

public boolean getDragEnabled()

Возвращает, включена ли автоматическая обработка перетаскивания.

Возвращает:

значение свойства dragEnabled

Начиная с версии:

1.4

См. также:

setDropMode

public final void setDropMode(DropMode dropMode)

Задает режим сброса для этого компонента. Для обратной совместимости значением этого свойства по умолчанию является DropMode.USE_SELECTION. Однако для улучшения взаимодействия с пользователем рекомендуется использовать один из других режимов. Например, DropMode.ON позволяет добиться аналогичного поведения, при котором элементы отображаются как выбранные, но при этом фактическое выделение в дереве не изменяется.

JTree поддерживает следующие режимы сброса:

DropMode.USE_SELECTION
DropMode.ON
DropMode.INSERT
DropMode.ON_OR_INSERT

Режим сброса имеет смысл только в том случае, если у компонента есть TransferHandler, допускающий сброс.

Параметры:

dropMode — используемый режим сброса

Вызывает исключение:

IllegalArgumentException — если режим сброса не поддерживается или null

Начиная с версии:

1.6

См. также:

getDropMode

public final DropMode getDropMode()

Возвращает режим сброса для этого компонента.

Возвращает:

режим сброса для этого компонента

Начиная с версии:

1.6

См. также:

getDropLocation

@BeanProperty(bound=false) public final JTree.DropLocation getDropLocation()

Возвращает расположение, которое компонент должен визуально обозначить как место сброса во время операции DnD над компонентом, или null, если в данный момент место сброса не должно отображаться.

Этот метод не предназначен для получения места сброса из TransferHandler, поскольку место сброса задается только после возврата canImport из TransferHandler и разрешения отобразить это место.

При изменении этого свойства компонент генерирует событие изменения свойства с именем "dropLocation".

Возвращает:

место сброса

Начиная с версии:

1.6

См. также:

isPathEditable

public boolean isPathEditable(TreePath path)

Возвращает isEditable. Этот метод вызывается пользовательским интерфейсом до начала редактирования, чтобы убедиться, что указанный путь можно редактировать. Он предоставлен как точка расширения для создания подклассов, позволяющая добавлять фильтрацию редактирования без необходимости создавать новый редактор.

Параметры:

path — TreePath, идентифицирующий узел

Возвращает:

true, если редактировать можно каждый родительский узел и сам узел

См. также:

getToolTipText

public String getToolTipText(MouseEvent event)

Переопределяет метод getToolTipText класса JComponent, чтобы можно было использовать подсказки средства отображения, если для него задан текст.

ПРИМЕЧАНИЕ. Чтобы JTree корректно отображал подсказки своих средств отображения, JTree должен быть зарегистрированным компонентом в ToolTipManager. Для этого можно вызвать ToolTipManager.sharedInstance().registerComponent(tree). Автоматически это не выполняется!

Переопределяет:: getToolTipText в классе JComponent
Параметры:: event — MouseEvent, инициировавшее отображение ToolTip
Возвращает:: строку с текстом подсказки или null, если event равно null

convertValueToText

public String convertValueToText(Object value, boolean selected, boolean expanded, boolean leaf, int row, boolean hasFocus)

Вызывается средствами отображения для преобразования указанного значения в текст. Эта реализация возвращает value.toString и игнорирует остальные аргументы. Чтобы управлять преобразованием, создайте подкласс и переопределите этот метод, используя необходимые аргументы.

Параметры:: value — Object для преобразования в текст; selected — true, если узел выбран; expanded — true, если узел развернут; leaf — true, если узел является листовым; row — целое число, задающее строку отображения узла, где 0 — первая строка отображения; hasFocus — true, если узел находится в фокусе
Возвращает:: представление значения узла в виде String

getRowCount

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

Возвращает количество отображаемых узлов. Узел считается отображаемым, если все его родительские узлы развернуты. Корневой узел включается в это количество, только если isRootVisible() равно true. Если пользовательский интерфейс не задан, возвращает 0.

Возвращает:: количество отображаемых узлов

setSelectionPath

public void setSelectionPath(TreePath path)

Выбирает узел, заданный указанным путем. Если какой-либо элемент пути скрыт (находится под свернутым узлом) и getExpandsSelectedPaths равно true, этот узел раскрывается (становится видимым).

Параметры:: path — TreePath, задающий выбираемый узел

setSelectionPaths

public void setSelectionPaths(TreePath[] paths)

Выбирает узлы, заданные указанным массивом путей. Если какой-либо элемент любого из путей скрыт (находится под свернутым узлом) и getExpandsSelectedPaths равно true, этот узел раскрывается (становится видимым).

Параметры:: paths — массив объектов TreePath, задающий выбираемые узлы

setLeadSelectionPath

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

Задает путь, определенный как ведущий. Ведущий элемент может быть не выбран. Ведущий элемент не поддерживается объектом JTree; вместо этого его обновляет пользовательский интерфейс.

Это связанное свойство.

Параметры:: newPath — новый ведущий путь
Начиная с версии:: 1.3

setAnchorSelectionPath

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

Задает путь, определенный как опорный. Опорный элемент не поддерживается объектом JTree; вместо этого его обновляет пользовательский интерфейс.

Это связанное свойство.

Параметры:: newPath — новый опорный путь
Начиная с версии:: 1.3

setSelectionRow

public void setSelectionRow(int row)

Выбирает узел в указанной строке отображения.

Параметры:: row — выбираемая строка, где 0 — первая строка отображения

setSelectionRows

public void setSelectionRows(int[] rows)

Выбирает узлы, соответствующие каждой из указанных строк отображения. Если конкретный элемент rows меньше < 0 или больше либо равен >= getRowCount, он будет проигнорирован. Если ни один из элементов rows не соответствует допустимой строке, выделение будет снято. Иными словами, будет вызван clearSelection.

Параметры:: rows — массив целых чисел, задающий выбираемые строки, где 0 соответствует первой строке отображения

addSelectionPath

public void addSelectionPath(TreePath path)

Добавляет узел, заданный указанным TreePath, к текущему выделению. Если какой-либо элемент пути не отображается и getExpandsSelectedPaths равно true, он становится видимым.

Обратите внимание, что JTree не допускает существования одинаковых узлов среди дочерних элементов одного родителя: каждый соседний узел должен быть уникальным объектом.

Параметры:: path — добавляемый TreePath

addSelectionPaths

public void addSelectionPaths(TreePath[] paths)

Добавляет каждый путь из массива путей к текущему выделению. Если какой-либо элемент любого из путей не отображается и getExpandsSelectedPaths равно true, он становится видимым.

Параметры:: paths — массив объектов TreePath, задающий добавляемые узлы

addSelectionRow

public void addSelectionRow(int row)

Добавляет путь из указанной строки к текущему выделению.

Параметры:: row — целое число, задающее строку добавляемого узла, где 0 — первая строка отображения

addSelectionRows

public void addSelectionRows(int[] rows)

Добавляет пути из каждой указанной строки к текущему выделению.

Параметры:: rows — массив целых чисел, задающий добавляемые строки, где 0 соответствует первой строке отображения

getLastSelectedPathComponent

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

Возвращает последний компонент выбранного пути. Это вспомогательный метод для getSelectionModel().getSelectionPath().getLastPathComponent(). Обычно он полезен только в том случае, если выделен один путь.

Возвращает:

последний компонент выбранного пути или null, если ничего не выбрано

См. также:

getLeadSelectionPath

public TreePath getLeadSelectionPath()

Возвращает путь, определенный как ведущий.

Возвращает:: путь, определенный как ведущий

getAnchorSelectionPath

public TreePath getAnchorSelectionPath()

Возвращает путь, определенный как опорный.

Возвращает:: путь, определенный как опорный
Начиная с версии:: 1.3

getSelectionPath

public TreePath getSelectionPath()

Возвращает путь к первому выбранному узлу.

Возвращает:: TreePath для первого выбранного узла или null, если в данный момент ничего не выбрано

getSelectionPaths

public TreePath[] getSelectionPaths()

Возвращает пути ко всем выбранным значениям.

Возвращает:: массив объектов TreePath, указывающих на выбранные узлы, или null, если в данный момент ничего не выбрано

getSelectionRows

public int[] getSelectionRows()

Возвращает все строки, выбранные в данный момент. Этот метод просто перенаправляет вызов в TreeSelectionModel. Если ничего не выбрано, будет возвращено null или пустой массив — в зависимости от реализации TreeSelectionModel.

Возвращает:: массив целых чисел, задающих все выбранные в данный момент строки, где 0 — первая строка отображения

getSelectionCount

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

Возвращает количество выбранных узлов.

Возвращает:: количество выбранных узлов

getMinSelectionRow

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

Возвращает наименьшую из выбранных строк. Если выделение пусто или ни один из выбранных путей не отображается, возвращается -1.

Возвращает:: наименьшая из выбранных строк

getMaxSelectionRow

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

Возвращает наибольшую из выбранных строк. Если выделение пусто или ни один из выбранных путей не отображается, возвращается -1.

Возвращает:: наибольшая из выбранных строк

getLeadSelectionRow

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

Возвращает индекс строки, соответствующий ведущему пути.

Возвращает:: целое число, задающее индекс строки ведущего пути, где 0 — первая строка отображения; или -1, если leadPath равно null

isPathSelected

public boolean isPathSelected(TreePath path)

Возвращает true, если элемент, заданный путем, выбран в данный момент.

Параметры:: path — TreePath, идентифицирующий узел
Возвращает:: true, если узел выбран

isRowSelected

public boolean isRowSelected(int row)

Возвращает true, если узел, заданный строкой, выбран.

Параметры:: row — целое число, задающее строку отображения, где 0 — первая строка отображения
Возвращает:: true, если узел выбран

getExpandedDescendants

public Enumeration<TreePath> getExpandedDescendants(TreePath parent)

Возвращает Enumeration потомков пути parent, которые в данный момент развернуты. Если parent в данный момент не развернут, будет возвращено null. Если во время перебора возвращенного Enumeration развернуть или свернуть узлы, метод может не вернуть все развернутые пути или вернуть пути, которые больше не развернуты.

Параметры:: parent — путь для проверки
Возвращает:: Enumeration потомков parent или null, если parent в данный момент не развернут

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)

Возвращает true, если узел, заданный путем, когда-либо разворачивался.

Параметры:: path — TreePath, идентифицирующий узел
Возвращает:: true, если path когда-либо разворачивался

isExpanded

public boolean isExpanded(TreePath path)

Возвращает true, если узел, заданный путем, в данный момент развернут.

Параметры:: path — TreePath, задающий проверяемый узел
Возвращает:: false, если какой-либо узел в пути узла свернут; true, если все узлы в пути развернуты

isExpanded

public boolean isExpanded(int row)

Возвращает true, если узел в указанной строке отображения в данный момент развернут.

Параметры:: row — проверяемая строка, где 0 — первая строка отображения
Возвращает:: true, если узел в данный момент развернут; в противном случае false

isCollapsed

public boolean isCollapsed(TreePath path)

Возвращает true, если значение, заданное путем, в данный момент свернуто. Метод вернет false, если какое-либо из значений в пути в данный момент не отображается.

Параметры:: path — проверяемый TreePath
Возвращает:: true, если какой-либо узел в пути узла свернут; false, если все узлы в пути развернуты

isCollapsed

public boolean isCollapsed(int row)

Возвращает true, если узел в указанной строке отображения свернут.

Параметры:: row — проверяемая строка, где 0 — первая строка отображения
Возвращает:: true, если узел в данный момент свернут; в противном случае false

makeVisible

public void makeVisible(TreePath path)

Обеспечивает отображение узла, заданного путем.

Параметры:: path — TreePath, который необходимо сделать видимым

isVisible

public boolean isVisible(TreePath path)

Возвращает true, если значение, заданное путем, в данный момент отображается, то есть является корневым узлом или все его родительские узлы развернуты. В противном случае метод возвращает false.

Параметры:: path — TreePath, идентифицирующий узел
Возвращает:: true, если узел отображается; в противном случае false

getPathBounds

public Rectangle getPathBounds(TreePath path)

Возвращает Rectangle, в которой будет нарисован указанный узел. Возвращает null, если какой-либо элемент пути скрыт (находится под свернутым родительским узлом).

Примечание:
Этот метод возвращает допустимую область, даже если указанный узел в данный момент не отображается.

Параметры:: path — TreePath, идентифицирующий узел
Возвращает:: Rectangle, в которой рисуется узел, или null

getRowBounds

public Rectangle getRowBounds(int row)

Возвращает Rectangle, в которой рисуется узел из указанной строки.

Параметры:: row — строка для отображения, где 0 — первая строка отображения
Возвращает:: Rectangle, в которой рисуется узел

scrollPathToVisible

public void scrollPathToVisible(TreePath path)

Обеспечивает развертывание всех компонентов пути (кроме последнего компонента пути) и прокручивает область так, чтобы узел, заданный путем, оказался на экране. Работает только в том случае, если этот JTree находится внутри JScrollPane.

Параметры:: path — TreePath, идентифицирующий узел, который необходимо показать

scrollRowToVisible

public void scrollRowToVisible(int row)

Прокручивает элемент, заданный строкой, до появления на экране. Выполняется минимальная прокрутка, необходимая для отображения строки. Работает только в том случае, если этот JTree находится внутри JScrollPane.

Параметры:: row — целое число, задающее прокручиваемую строку, где 0 — первая строка отображения

getPathForRow

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

Возвращает путь для указанной строки. Если row не виден или TreeUI не задан, возвращается null.

Параметры:: row — целое число, задающее строку
Возвращает:: TreePath к указанному узлу, null, если row < 0 или row >= getRowCount()

getRowForPath

public int getRowForPath(TreePath path)

Возвращает строку, в которой отображается узел, заданный указанным путем.

Параметры:: path — TreePath, идентифицирующий узел
Возвращает:: целое число, задающее строку отображения, где 0 — первая строка отображения; или -1, если какой-либо элемент пути скрыт под свернутым родительским узлом.

expandPath

public void expandPath(TreePath path)

Обеспечивает разворачивание и отображение узла, заданного указанным путем. Если последний элемент пути является листом, метод ничего не делает.

Параметры:: path — TreePath, идентифицирующий узел

expandRow

public void expandRow(int row)

Обеспечивает разворачивание и отображение узла в указанной строке.

Если row меньше < 0 или больше либо равен >= getRowCount, метод ничего не делает.

Параметры:: row — целое число, задающее строку отображения, где 0 — первая строка отображения

collapsePath

public void collapsePath(TreePath path)

Обеспечивает сворачивание и отображение узла, заданного указанным путем.

Параметры:: path — TreePath, идентифицирующий узел

collapseRow

public void collapseRow(int row)

Свернуть узел в указанной строке.

Если row < 0 или >= getRowCount, это не даст никакого эффекта.

Параметры:: row — целое число, задающее отображаемую строку, где 0 — первая строка в области отображения

getPathForLocation

public TreePath getPathForLocation(int x, int y)

Возвращает путь к узлу в указанной позиции.

Параметры:: x — целое число, задающее расстояние в пикселях по горизонтали от левого края области отображения за вычетом левого поля; y — целое число, задающее расстояние в пикселях по вертикали от верхнего края области отображения за вычетом верхнего поля
Возвращает:: TreePath для узла в этой позиции

getRowForLocation

public int getRowForLocation(int x, int y)

Возвращает строку для указанной позиции.

Параметры:

x — целое число, задающее расстояние в пикселях по горизонтали от левого края области отображения за вычетом левого поля

y — целое число, задающее расстояние в пикселях по вертикали от верхнего края области отображения за вычетом верхнего поля

Возвращает:

строку, соответствующую этой позиции, или -1, если позиция находится за пределами отображаемой ячейки

См. также:

getClosestPathForLocation

public TreePath getClosestPathForLocation(int x, int y)

Возвращает путь к узлу, ближайшему к x,y. Если в данный момент нет видимых узлов или отсутствует модель, возвращает null, в противном случае всегда возвращает допустимый путь. Чтобы проверить, находится ли узел точно в точке x, y, получите границы узла и проверьте, входит ли в них точка x, y.

Параметры:

Возвращает:

TreePath для узла, ближайшего к этой позиции; null, если ничего не отображается или отсутствует модель

См. также:

getClosestRowForLocation

public int getClosestRowForLocation(int x, int y)

Возвращает строку узла, ближайшего к x,y. Если нет видимых узлов или отсутствует модель, возвращает -1. В противном случае всегда возвращает допустимую строку. Чтобы проверить, находится ли возвращенный объект точно в точке x, y, получите границы узла в возвращенной строке и проверьте, входит ли в них точка x, y.

Параметры:

Возвращает:

строку, ближайшую к этой позиции; -1, если ничего не отображается или отсутствует модель

См. также:

isEditing

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

Возвращает true, если дерево редактируется. Получить редактируемый элемент можно с помощью getSelectionPath.

Возвращает:

true, если пользователь в данный момент редактирует узел

См. также:

stopEditing

public boolean stopEditing()

Завершает текущий сеанс редактирования. (Объект DefaultTreeCellEditor сохраняет все изменения ячейки, сделанные на данный момент. Другие реализации могут работать иначе.) Ничего не делает, если дерево не редактируется.

Примечание:
Чтобы изменения сохранялись автоматически при каждом перемещении пользователя по дереву, используйте setInvokesStopCellEditing(boolean).

Возвращает:: true, если редактирование выполнялось и теперь остановлено; false, если редактирование не выполнялось

cancelEditing

public void cancelEditing()

Отменяет текущий сеанс редактирования. Ничего не делает, если дерево не редактируется.

startEditingAtPath

public void startEditingAtPath(TreePath path)

Выбирает узел, указанный заданным путем, и начинает редактирование. Попытка редактирования не удастся, если CellEditor не разрешает редактирование указанного элемента.

Параметры:: path — TreePath, указывающий узел

getEditingPath

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

Возвращает путь к элементу, который редактируется в данный момент.

Возвращает:: TreePath редактируемого узла

setSelectionModel

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

Задает модель выбора дерева. Если указано значение null, используется пустая selectionModel, которая не допускает выбор.

Это связанное свойство.

Параметры:

selectionModel — используемая TreeSelectionModel или null, чтобы отключить выбор

См. также:

getSelectionModel

public TreeSelectionModel getSelectionModel()

Возвращает модель выбора. Она всегда должна возвращать значение, отличное от null. Если выбор не требуется, задайте для модели выбора значение null, в результате чего будет использоваться пустая модель выбора.

Возвращает:

модель выбора

См. также:

getPathBetweenRows

protected TreePath[] getPathBetweenRows(int index0, int index1)

Возвращает пути (включая границы) между указанными строками. Если указанные индексы находятся в пределах набора видимых строк или ограничивают его, индексы приводятся к границам набора видимых строк. Если указанные индексы не входят в набор видимых строк и не ограничивают его, возвращается пустой массив. Например, если число строк равно 10 и этот метод вызван с аргументами -1, 20, указанные индексы приводятся к набору видимых строк; это равносильно вызову с аргументами 0, 9. С другой стороны, при вызове с аргументами -10, -1 указанные индексы не ограничивают набор видимых строк, и возвращается пустой массив.

Порядок параметров не имеет значения. То есть getPathBetweenRows(x, y) эквивалентно getPathBetweenRows(y, x).

Пустой массив возвращается, если число строк равно 0 или указанные индексы не ограничивают набор видимых строк.

Параметры:: index0 — первый индекс диапазона; index1 — последний индекс диапазона
Возвращает:: пути (включая границы) между указанными индексами строк

setSelectionInterval

public void setSelectionInterval(int index0, int index1)

Выбирает строки в указанном интервале (включая границы). Если указанные индексы находятся в пределах набора видимых строк или ограничивают его, выбранные строки приводятся к границам набора видимых строк. Если указанные индексы не входят в набор видимых строк и не ограничивают его, выбор снимается. Например, если число строк равно

и этот метод вызван с аргументами -1, 20, указанные индексы ограничивают видимый диапазон; это равносильно вызову с аргументами 0, 9. С другой стороны, при вызове с аргументами -10, -1 указанные индексы не ограничивают набор видимых строк, и выбор снимается.

Порядок параметров не имеет значения. То есть setSelectionInterval(x, y) эквивалентно setSelectionInterval(y, x).

Параметры:: index0 — первый индекс диапазона для выбора; index1 — последний индекс диапазона для выбора

addSelectionInterval

public void addSelectionInterval(int index0, int index1)

Добавляет указанные строки (включая границы) в выбор. Если указанные индексы находятся в пределах набора видимых строк или ограничивают его, они приводятся к границам набора видимых строк. Если индексы не входят в набор видимых строк и не ограничивают его, выбор остается без изменений. Например, если число строк равно 10 и этот метод вызван с аргументами -1, 20, указанные индексы ограничивают видимый диапазон; это равносильно вызову с аргументами 0, 9. С другой стороны, при вызове с аргументами -10, -1 указанные индексы не ограничивают набор видимых строк, и выбор остается без изменений.

Порядок параметров не имеет значения. То есть addSelectionInterval(x, y) эквивалентно addSelectionInterval(y, x).

Параметры:: index0 — первый индекс диапазона, добавляемого в выбор; index1 — последний индекс диапазона, добавляемого в выбор

removeSelectionInterval

public void removeSelectionInterval(int index0, int index1)

Удаляет указанные строки (включая границы) из выбора. Если указанные индексы находятся в пределах набора видимых строк или ограничивают его, они приводятся к границам набора видимых строк. Если указанные индексы не входят в набор видимых строк и не ограничивают его, выбор остается без изменений. Например, если число строк равно

и этот метод вызван с аргументами -1, 20, указанный диапазон ограничивает видимый диапазон; это равносильно вызову с аргументами 0, 9. С другой стороны, при вызове с аргументами -10, -1 указанный диапазон не ограничивает набор видимых строк, и выбор остается без изменений.

Порядок параметров не имеет значения. То есть removeSelectionInterval(x, y) эквивалентно removeSelectionInterval(y, x).

Параметры:: index0 — первая строка, удаляемая из выбора; index1 — последняя строка, удаляемая из выбора

removeSelectionPath

public void removeSelectionPath(TreePath path)

Удаляет узел, указанный заданным путем, из текущего выбора.

Параметры:: path — TreePath, указывающий узел

removeSelectionPaths

public void removeSelectionPaths(TreePath[] paths)

Удаляет узлы, указанные заданными путями, из текущего выбора.

Параметры:: paths — массив объектов TreePath, указывающий удаляемые узлы

removeSelectionRow

public void removeSelectionRow(int row)

Удаляет строку с индексом row из текущего выбора.

Параметры:: row — удаляемая строка

removeSelectionRows

public void removeSelectionRows(int[] rows)

Удаляет выбранные строки с каждым из указанных номеров.

Параметры:: rows — массив целых чисел, задающих отображаемые строки, где 0 — первая строка в области отображения

clearSelection

public void clearSelection()

Снимает выбор.

isSelectionEmpty

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

Возвращает true, если в данный момент ничего не выбрано.

Возвращает:: true, если в данный момент ничего не выбрано

addTreeExpansionListener

public void addTreeExpansionListener(TreeExpansionListener tel)

Добавляет слушателя событий TreeExpansion.

Параметры:: tel — TreeExpansionListener, который будет получать уведомления при раскрытии или сворачивании узла дерева («отрицательное раскрытие»)

removeTreeExpansionListener

public void removeTreeExpansionListener(TreeExpansionListener tel)

Удаляет слушателя событий TreeExpansion.

Параметры:: tel — удаляемый TreeExpansionListener

getTreeExpansionListeners

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

Возвращает массив всех объектов TreeExpansionListener, добавленных в этот JTree с помощью addTreeExpansionListener().

Возвращает:: все добавленные объекты TreeExpansionListener или пустой массив, если слушатели не добавлены
Начиная с версии:: 1.4

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)

Добавляет слушателя событий TreeWillExpand.

Параметры:: tel — TreeWillExpandListener, который будет получать уведомления перед раскрытием или сворачиванием узла дерева («отрицательное раскрытие»)

removeTreeWillExpandListener

public void removeTreeWillExpandListener(TreeWillExpandListener tel)

Удаляет слушателя событий TreeWillExpand.

Параметры:: tel — удаляемый TreeWillExpandListener

getTreeWillExpandListeners

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

Возвращает массив всех объектов TreeWillExpandListener, добавленных в этот JTree с помощью addTreeWillExpandListener().

Возвращает:: все добавленные объекты TreeWillExpandListener или пустой массив, если слушатели не добавлены
Начиная с версии:: 1.4

fireTreeExpanded

public void fireTreeExpanded(TreePath path)

Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. Экземпляр события создается при необходимости с использованием параметра path.

Параметры:

path — TreePath, указывающий раскрытый узел

См. также:

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)

Параметры:

path — TreePath, указывающий свернутый узел

См. также:

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path) throws ExpandVetoException

Параметры:

path — TreePath, указывающий узел, который будет раскрыт

Исключения:

ExpandVetoException — если раскрытие невозможно выполнить

См. также:

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException

Параметры:

path — TreePath, указывающий узел, который будет свернут

Исключения:

ExpandVetoException — если сворачивание невозможно выполнить

См. также:

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

Добавляет слушателя событий TreeSelection.

Параметры:: tsl — TreeSelectionListener, который будет получать уведомления при выборе или снятии выбора узла («отрицательный выбор»)

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)

Удаляет слушателя TreeSelection.

Параметры:: tsl — удаляемый TreeSelectionListener

getTreeSelectionListeners

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

Возвращает массив всех объектов TreeSelectionListener, добавленных в этот JTree с помощью addTreeSelectionListener().

Возвращает:: все добавленные объекты TreeSelectionListener или пустой массив, если слушатели не добавлены
Начиная с версии:: 1.4

fireValueChanged

protected void fireValueChanged(TreeSelectionEvent e)

Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа.

Параметры:

e — отправляемое событие TreeSelectionEvent; создается объектом TreeSelectionModel при выборе или снятии выбора узла

См. также:

treeDidChange

public void treeDidChange()

Вызывается, когда дерево изменилось настолько, что необходимо изменить размеры границ, но недостаточно для удаления набора раскрытых узлов (например, узлы были раскрыты или свернуты либо в дерево были добавлены узлы). Вам не следует вызывать этот метод самостоятельно: пользовательский интерфейс вызовет его при необходимости.

setVisibleRowCount

@BeanProperty(description="The number of rows that are to be displayed.") public void setVisibleRowCount(int newCount)

Задает количество отображаемых строк. Это работает только в том случае, если дерево находится внутри JScrollPane, и изменяет предпочтительный размер и размер этой панели прокрутки.

Это связанное свойство.

Параметры:: newCount — количество отображаемых строк

getVisibleRowCount

public int getVisibleRowCount()

Возвращает количество строк, отображаемых в области отображения.

Возвращает:: количество отображаемых строк

getNextMatch

public TreePath getNextMatch(String prefix, int startingRow, Position.Bias bias)

Возвращает TreePath следующего элемента дерева, имя которого начинается с заданного префикса. Для преобразования TreePath в строку используется convertValueToText.

Параметры:: prefix — строка, используемая для поиска совпадения; startingRow — строка, с которой начинается поиск; bias — направление поиска: Position.Bias.Forward или Position.Bias.Backward.
Возвращает:: TreePath следующего элемента дерева, начинающегося с заданного префикса; в противном случае — null
Исключения:: IllegalArgumentException — если prefix равен null или startingRow выходит за допустимые границы
Начиная с версии:: 1.4

getPreferredScrollableViewportSize

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

Возвращает предпочтительный размер области отображения для JTree. Высота определяется параметром getVisibleRowCount, а ширина соответствует текущей предпочтительной ширине.

Определено в:

getPreferredScrollableViewportSize в интерфейсе Scrollable

Возвращает:

объект Dimension, содержащий предпочтительный размер

См. также:

getScrollableUnitIncrement

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

Возвращает величину смещения при прокрутке. Она равна высоте первой отображаемой строки, которая видна не полностью, или, если она видна целиком, высоте следующей строки в направлении прокрутки.

Определено в:

getScrollableUnitIncrement в интерфейсе Scrollable

Параметры:

visibleRect — видимая в области просмотра область отображения

orientation — SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

direction — меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо

Возвращает:

«единичное» смещение для прокрутки в указанном направлении

См. также:

getScrollableBlockIncrement

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

Возвращает величину блочного смещения, равную высоте или ширине visibleRect в зависимости от orientation.

Определено в:

getScrollableBlockIncrement в интерфейсе Scrollable

Параметры:

visibleRect — видимая в области просмотра область отображения

orientation — SwingConstants.VERTICAL или SwingConstants.HORIZONTAL

direction — меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.

Возвращает:

«блочное» смещение для прокрутки в указанном направлении

См. также:

getScrollableTracksViewportWidth

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

Возвращает false, указывая, что ширина области просмотра не определяет ширину таблицы, если только предпочтительная ширина дерева не меньше ширины области просмотра. Иными словами, дерево не должно быть меньше области просмотра.

Определено в:

getScrollableTracksViewportWidth в интерфейсе Scrollable

Возвращает:

должно ли дерево подстраиваться под ширину области просмотра

См. также:

getScrollableTracksViewportHeight

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

Возвращает false, указывая, что высота области просмотра не определяет высоту таблицы, если только предпочтительная высота дерева не меньше высоты области просмотра. Иными словами, дерево не должно быть меньше области просмотра.

Определено в:

getScrollableTracksViewportHeight в интерфейсе Scrollable

Возвращает:

должно ли дерево подстраиваться под высоту области просмотра

См. также:

setExpandedState

protected void setExpandedState(TreePath path, boolean state)

Задает состояние раскрытия для этого JTree. Если state равно true, все родительские узлы path и пути помечаются как раскрытые. Если state равно false, все родительские узлы path помечаются как EXPANDED, но сам path помечается как свернутый.

Операция завершится неудачей, если TreeWillExpandListener ее запретит.

Параметры:: path — TreePath, указывающий узел; state — если true, все родительские узлы path и пути помечаются как раскрытые. В противном случае все родительские узлы path помечаются как EXPANDED, но сам path помечается как свернутый.

getDescendantToggledPaths

protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)

Возвращает Enumeration TreePaths, которые были раскрыты и являются потомками parent.

Параметры:: parent — путь
Возвращает:: Enumeration TreePaths

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)

Удаляет всех потомков TreePaths в toRemove, которые были раскрыты.

Параметры:: toRemove — перечисление путей для удаления; значение null игнорируется
Исключения:: ClassCastException — если toRemove содержит элемент, который не является TreePath; значения null игнорируются

clearToggledPaths

protected void clearToggledPaths()

Очищает кэш переключённых путей дерева. При этом НЕ отправляются события TreeExpansionListener.

createTreeModelListener

protected TreeModelListener createTreeModelListener()

Создаёт и возвращает экземпляр TreeModelHandler. Возвращённый объект отвечает за обновление состояния раскрытия при изменении TreeModel.

Дополнительные сведения о значении состояния раскрытия см. выше в описании JTree description.

Возвращает:: экземпляр TreeModelHandler

removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)

Удаляет из выделения все пути, являющиеся потомками path. Если includePath имеет значение true и path выделен, он будет удалён из выделения.

Параметры:: path — путь; includePath — имеет значение true, и path выделен; он будет удалён из выделения.
Возвращает:: true, если был выделен потомок
С:: 1.3

paramString

protected String paramString()

Возвращает строковое представление этого JTree. Этот метод предназначен только для отладки; содержимое и формат возвращаемой строки могут различаться в разных реализациях. Возвращаемая строка может быть пустой, но не может быть null.

Переопределяет:: paramString в классе JComponent
Возвращает:: строковое представление этого JTree.

getAccessibleContext

@BeanProperty(bound=false) public AccessibleContext getAccessibleContext()

Получает AccessibleContext, связанный с этим JTree. Для JTree объект AccessibleContext имеет тип AccessibleJTree. При необходимости создаётся новый экземпляр AccessibleJTree.

Определено в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: объект AccessibleJTree, выполняющий роль AccessibleContext этого 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/JTree.html