Класс 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

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

Узел дерева можно определить либо по 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(javax.swing.tree.TreeCellRenderer), чтобы указать дереву использовать его. Для редактирования таких узлов подклассируйте TreeCellEditor и используйте setCellEditor(javax.swing.tree.TreeCellEditor).

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

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

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

Since:: 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` в качестве источника и передает его всем слушателям.

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

JComponent.AccessibleJComponent

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

Container.AccessibleAWTContainer

Вложенные классы/интерфейсы, объявленные в классе java.awt.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`	Количество строк для одновременного отображения.

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

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

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

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Поля, объявленные в интерфейсе java.awt.image.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()`	Возвращает местоположение, которое этот компонент должен визуально указывать как место перетаскивания во время операции перетаскивания над компонентом, или `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)`	Переопределяет метод `JComponent`'s `getToolTipText`, чтобы разрешить использование подсказок рендерера, если в нём установлен текст.
`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)`	Убеждается, что все компоненты пути в пути раскрыты (кроме последнего компонента пути) и прокручивает так, чтобы узел, идентифицируемый путем, отображался.
`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)`	Указывает, должна ли UI использовать большую модель.
`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)`	Выделяет узел в указанной строке отображения.

END_OF_DOCUMENT_MARKER

`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)`	Выбирает узел, идентифицированный указанным путем, и начинает редактирование.
`void`	`setVisibleRowCount(int newCount)`	Завершает текущую сессию редактирования.
`void`	`treeDidChange()`	Отправка уведомления, когда дерево достаточно изменилось, чтобы потребовалось изменить границы, но недостаточно, чтобы потребовалось удалить набор раскрытых узлов (например, узлы были раскрыты или свернуты, или узлы были вставлены в дерево).
`void`	`updateUI()`	Уведомление от `UIManager`, что L&F изменился.

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

Methods declared in class java.awt.Container

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

Methods declared in class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, 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

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

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

Since:

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

Возвращает объект L&F, который отображает этот компонент.

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

setUI

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

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

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

Параметры:

ui - объект TreeUI L&F

См. также:

updateUI

public void updateUI()

Уведомление от UIManager о том, что L&F изменился. Заменяет текущий объект UI последней версией из UIManager.

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

updateUI в классе JComponent

См. также:

getUIClassID

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

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

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

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

См. также:

END_OF_DOCUMENT_MARKER

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 , который принимает перетаскивание.

Parameters:

dropMode - режим перетаскивания для использования

Throws:

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

Since:

1.6

See Also:

getDropMode

public final DropMode getDropMode()

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

Returns:

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

Since:

1.6

See Also:

getDropLocation

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

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

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

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

Returns:

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

Since:

1.6

See Also:

isPathEditable

public boolean isPathEditable(TreePath path)

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

Parameters:

path - TreePath , определяющий узел

Returns:

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

See Also:

getToolTipText

public String getToolTipText(MouseEvent event)

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

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

Overrides:: getToolTipText в классе JComponent
Parameters:: event - MouseEvent , который инициировал отображение ToolTip
Returns:: строка, содержащая подсказку, или null , если event равно null

convertValueToText

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

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

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

getRowCount

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

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

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

setSelectionPath

public void setSelectionPath(TreePath path)

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

Parameters:: path - TreePath , определяющий узел для выбора

setSelectionPaths

public void setSelectionPaths(TreePath[] paths)

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

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

setLeadSelectionPath

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

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

Это свойство привязки.

Parameters:: newPath - новый ведущий путь
Since:: 1.3

setAnchorSelectionPath

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

Устанавливает путь, определяемый как якорь. Якорь не поддерживается JTree, а UI будет обновлять его.

Это свойство привязки.

Parameters:: newPath - новый путь якоря
Since:: 1.3

setSelectionRow

public void setSelectionRow(int row)

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

Parameters:: row - строка для выбора, где 0 - первая строка в отображении

setSelectionRows

public void setSelectionRows(int[] rows)

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

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

addSelectionPath

public void addSelectionPath(TreePath path)

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

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

Parameters:: path - TreePath для добавления

addSelectionPaths

public void addSelectionPaths(TreePath[] paths)

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

Parameters:: paths - массив объектов TreePath, определяющих узлы для добавления

addSelectionRow

public void addSelectionRow(int row)

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

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

addSelectionRows

public void addSelectionRows(int[] rows)

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

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

getLastSelectedPathComponent

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

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

Возвращает:

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

См. также:

getLeadSelectionPath

public TreePath getLeadSelectionPath()

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

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

getAnchorSelectionPath

public TreePath getAnchorSelectionPath()

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

Возвращает:: путь, идентифицированный как якорный
Since:: 1.3

getSelectionPath

public TreePath getSelectionPath()

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

Возвращает:: путь к первому выделенному узлу или 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)

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

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

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)

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

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

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)

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

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

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

getRowBounds

public Rectangle getRowBounds(int row)

Возвращает область, в которую нарисована строка узла в указанной строке.

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

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 - целое число, указывающее строку
Возвращает:: путь к указанному узлу, null если row < 0 или row >= getRowCount()

getRowForPath

public int getRowForPath(TreePath path)

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

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

expandPath

public void expandPath(TreePath path)

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

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

expandRow

public void expandRow(int row)

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

Если row меньше 0 или больше или равно getRowCount, это не повлияет.

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

collapsePath

public void collapsePath(TreePath path)

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

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

collapseRow

public void collapseRow(int row)

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

Если row меньше 0 или больше или равно getRowCount, это не повлияет.

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

getPathForLocation

public TreePath getPathForLocation(int x, int y)

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

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

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 по отношению к ним.

Параметры:

Возвращает:

путь к узлу, наиболее близкому к этому местоположению, 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 - путь, идентифицирующий узел

getEditingPath

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

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

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

setSelectionModel

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

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

Это свойство с привязкой.

Параметры:

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

См. также:

getSelectionModel

public TreeSelectionModel getSelectionModel()

Возвращает модель для выбора. Это должно всегда возвращать ненулевое значение. Если вы не хотите разрешать выбор, установите модель выбора в 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).

Parameters:: index0 - первый индекс в диапазоне для выделения; index1 - последний индекс в диапазоне для выделения

addSelectionInterval

public void addSelectionInterval(int index0, int index1)

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

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

Parameters:: index0 - первый индекс в диапазоне для добавления к выделению; index1 - последний индекс в диапазоне для добавления к выделению

removeSelectionInterval

public void removeSelectionInterval(int index0, int index1)

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

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

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

Parameters:: index0 - первая строка для удаления из выделения; index1 - последняя строка для удаления из выделения

removeSelectionPath

public void removeSelectionPath(TreePath path)

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

Parameters:: path - путь, идентифицирующий узел

removeSelectionPaths

public void removeSelectionPaths(TreePath[] paths)

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

Parameters:: paths - массив объектов, указывающих узлы для удаления

removeSelectionRow

public void removeSelectionRow(int row)

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

Parameters:: row - строка для удаления

removeSelectionRows

public void removeSelectionRows(int[] rows)

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

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

clearSelection

public void clearSelection()

Очищает выделение.

isSelectionEmpty

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

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

Returns:: true, если выделение в настоящее время пусто

addTreeExpansionListener

public void addTreeExpansionListener(TreeExpansionListener tel)

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

Parameters:: tel - слушатель TreeExpansionListener, который будет уведомляться, когда узел дерева будет развернут или свернут

removeTreeExpansionListener

public void removeTreeExpansionListener(TreeExpansionListener tel)

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

Parameters:: tel - слушатель для удаления

getTreeExpansionListeners

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

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

Returns:: все добавленные слушатели или пустой массив, если слушатели не добавлены
Since:: 1.4

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)

Добавляет слушателя для событий предстоящего расширения дерева.

Parameters:: tel - слушатель TreeWillExpandListener, который будет уведомляться о событии до расширения или свертывания узла.

removeTreeWillExpandListener

public void removeTreeWillExpandListener(TreeWillExpandListener tel)

Удаляет слушателя для событий предстоящего расширения дерева.

Parameters:: tel - слушатель для удаления

getTreeWillExpandListeners

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

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

Returns:: все добавленные слушатели или пустой массив, если слушатели не добавлены
Since:: 1.4

fireTreeExpanded

public void fireTreeExpanded(TreePath path)

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

Parameters:

path - путь, указывающий на узел, который был развернут

See Also:

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)

Parameters:

path - путь, указывающий на узел, который был свернут

See Also:

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path) throws ExpandVetoException

Parameters:

path - путь, указывающий на узел, который будет развернут

Throws:

ExpandVetoException - если расширение предотвращено

See Also:

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException

Parameters:

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

Throws:

ExpandVetoException - если свертывание предотвращено

See Also:

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

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

Parameters:: tsl - слушатель TreeSelectionListener, который будет уведомляться, когда узел выбран или убран из выбора

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)

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

Parameters:: tsl - слушатель для удаления

getTreeSelectionListeners

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

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

Returns:: все добавленные слушатели или пустой массив, если слушатели не добавлялись
Since:: 1.4

fireValueChanged

protected void fireValueChanged(TreeSelectionEvent e)

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

Parameters:

e - событие, которое нужно запустить; генерируется TreeSelectionModel при выборе или отмене выбора узла

See Also:

treeDidChange

public void treeDidChange()

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

setVisibleRowCount

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

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

Это свойство привязано.

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

getVisibleRowCount

public int getVisibleRowCount()

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

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

getNextMatch

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

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

Parameters:: prefix - строка для проверки соответствия; startingRow - строка для начала поиска; bias - направление поиска, либо Position.Bias.Forward, либо Position.Bias.Backward.
Returns:: TreePath следующего элемента дерева, начинающегося с префикса; в противном случае null
Throws:: IllegalArgumentException - если префикс null или начальная строка вне допустимого диапазона
Since:: 1.4

getPreferredScrollableViewportSize

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

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

Specified by:

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

Returns:

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

See Also:

getScrollableUnitIncrement

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

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

Specified by:

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

Parameters:

visibleRect - область просмотра, видимая внутри области просмотра

orientation - либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL

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

Returns:

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

See Also:

getScrollableBlockIncrement

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

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

Specified by:

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

Parameters:

visibleRect - область просмотра, видимая внутри области просмотра

orientation - либо SwingConstants.VERTICAL, либо SwingConstants.HORIZONTAL

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

Returns:

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

See Also:

getScrollableTracksViewportWidth

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

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

Specified by:

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

Returns:

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

See Also:

getScrollableTracksViewportHeight

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

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

Specified by:

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

Returns:

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

See Also:

setExpandedState

protected void setExpandedState(TreePath path, boolean state)

Устанавливает состояние развертывания этого JTree. Если state true, все родительские элементы path и путь помечаются как развернутые. Если state false, все родительские элементы path помечаются как РАЗВЕРНУТЫЕ, но сам path помечается как СВЕРНУТЫЙ.

Операция может быть отменена компонентом TreeWillExpandListener.

Parameters:: path - путь, идентифицирующий узел; state - если true, все родительские элементы path и путь помечаются как развернутые. В противном случае, все родительские элементы path помечаются как РАЗВЕРНУТЫЕ, но сам path помечается как СВЕРНУТЫЙ.

getDescendantToggledPaths

protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)

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

Parameters:: parent - путь
Returns:: список Enumeration пути TreePaths.

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)

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

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

clearToggledPaths

protected void clearToggledPaths()

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

createTreeModelListener

protected TreeModelListener createTreeModelListener()

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

Более подробную информацию о значении состояния развертывания см. в разделе JTree description выше.

Returns:: экземпляр TreeModelHandler

removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path, boolean includePath)

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

Parameters:: path - путь; includePath - если true true и path выделен, он будет удален из выделения.
Returns:: true, если потомок был выделен
Since:: 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, 2023, 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/21/docs/api/java.desktop/javax/swing/JTree.html