Класс 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` в качестве корня, который отображает корневой узел и определяет, является ли узел листом, указанным способом.

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

Modifier and Type	Method	Description
`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

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

cellRenderer

protected transient TreeCellRenderer cellRenderer

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

rowHeight

protected int rowHeight

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

showsRootHandles

protected boolean showsRootHandles

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

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

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

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

См. также:

rootVisible

selectionRedirector

protected transient JTree.TreeSelectionRedirector selectionRedirector

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

cellEditor

protected transient TreeCellEditor cellEditor

Редактор для записей. По умолчанию null (дерево не редактируется).

editable

protected boolean editable

Дерево редактируется? По умолчанию ложно.

largeModel

protected boolean largeModel

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

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

visibleRowCount

protected int visibleRowCount

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

invokesStopCellEditing

protected boolean invokesStopCellEditing

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

scrollsOnExpand

protected boolean scrollsOnExpand

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

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 с образцовой моделью. По умолчанию модель дерева определяет листовой узел как любой узел без дочерних узлов.

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Object[] value)

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

Параметры:

value - массив Object

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Vector<?> value)

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

Параметры:

value - Vector

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

public JTree(Hashtable<?,?> value)

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

Параметры:

value - Hashtable

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

public JTree(TreeNode root)

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

Параметры:

root - объект TreeNode

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

public JTree(TreeNode root, boolean asksAllowsChildren)

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

Параметры:

root - объект TreeNode

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

См. также:

DefaultTreeModel.asksAllowsChildren

JTree

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

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

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

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

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()

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

Возвращает:: стандартную 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 - объект L&F TreeUI

См. также:

UIDefaults.getUI(javax.swing.JComponent)

updateUI

public void updateUI()

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

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

updateUI в классе JComponent

См. также:

JComponent.updateUI()

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, если корневой узел дерева отображается

См. также:

rootVisible

END_OF_DOCUMENT_MARKER

setRootVisible

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

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

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

Parameters:

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

See Also:

rootVisible

setShowsRootHandles

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

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

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

Parameters:

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

See Also:

showsRootHandles
getShowsRootHandles()

getShowsRootHandles

public boolean getShowsRootHandles()

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

Returns:

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

See Also:

showsRootHandles

setRowHeight

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

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

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

Parameters:: rowHeight - высота каждой ячейки в пикселях

getRowHeight

public int getRowHeight()

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

Returns:: высота каждой строки

isFixedRowHeight

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

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

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

setLargeModel

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

Указывает, должна ли UI использовать большой шаблон. (Не все UI будут реализовывать это.) Срабатывает изменение свойства для LARGE_MODEL_PROPERTY.

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

Parameters:

newValue - true для того, чтобы предложить UI большой шаблон

See Also:

largeModel

isLargeModel

public boolean isLargeModel()

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

Returns:

true, если предлагается большой шаблон

See Also:

largeModel

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.

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

getInvokesStopCellEditing

public boolean getInvokesStopCellEditing()

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

Returns:

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

See Also:

setInvokesStopCellEditing(boolean)

setScrollsOnExpand

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

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

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

Parameters:

newValue - false для отключения прокрутки при раскрытии; true для включения

See Also:

getScrollsOnExpand()

getScrollsOnExpand

public boolean getScrollsOnExpand()

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

Returns:: значение свойства scrollsOnExpand

setToggleClickCount

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

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

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

Parameters:: clickCount - количество щелчков мышью для раскрытия или закрытия узла
Since:: 1.3

getToggleClickCount

public int getToggleClickCount()

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

Returns:: количество щелчков мышью перед раскрытием узла
Since:: 1.3

setExpandsSelectedPaths

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

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

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

Parameters:: newValue - новое значение для expandsSelectedPaths
Since:: 1.3

getExpandsSelectedPaths

public boolean getExpandsSelectedPaths()

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

Returns:

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

Since:

1.3

See Also:

setExpandsSelectedPaths(boolean)

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 дерева.

Parameters:

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

Throws:

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

Since:

1.4

See Also:

getDragEnabled

public boolean getDragEnabled()

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

Returns:

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

Since:

1.4

See Also:

setDragEnabled(boolean)

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:

setDropMode(javax.swing.DropMode)

getDropLocation

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

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

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

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

Returns:

расположение выгрузки

Since:

1.6

See Also:

isPathEditable

public boolean isPathEditable(TreePath path)

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

Parameters:

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

Returns:

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

See Also:

isEditable()

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 - значение Object для преобразования в текст; selected - true, если узел выбран; expanded - true, если узел раскрыт; leaf - true, если узел является листом; row - целое число, определяющее строку отображения узла, где 0 — первая строка в отображении; hasFocus - true, если узел имеет фокус
Returns:: представление String значения узла

getRowCount

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

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

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, а вместо этого пользовательский интерфейс будет его обновлять.

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

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

setAnchorSelectionPath

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

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

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

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 если ничего не выделено

См. также:

TreePath.getLastPathComponent()

getLeadSelectionPath

public TreePath getLeadSelectionPath()

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

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

getAnchorSelectionPath

public TreePath getAnchorSelectionPath()

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

Возвращает:: путь, идентифицированный как якорь
С момента:: 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. Если вы развертываете/сворачиваете узлы во время итерации по возвращенному массиву, он может не вернуть все развернутые пути или может вернуть пути, которые больше не развернуты.

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

Возвращает прямоугольник, в который будет нарисован указанный узел. Возвращает 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)

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

Parameters:: path - the TreePath identifying a node
Returns:: целое число, определяющее строку отображения, где 0 — это первая строка в отображении, или -1, если какие-либо элементы в пути скрыты под свернутым родительским элементом.

expandPath

public void expandPath(TreePath path)

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

Parameters:: path - the TreePath identifying a node

expandRow

public void expandRow(int row)

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

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

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

collapsePath

public void collapsePath(TreePath path)

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

Parameters:: path - the TreePath identifying a node

collapseRow

public void collapseRow(int row)

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

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

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

getPathForLocation

public TreePath getPathForLocation(int x, int y)

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

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

getRowForLocation

public int getRowForLocation(int x, int y)

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

Parameters:

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

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

Returns:

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

See Also:

getClosestRowForLocation(int, int)

getClosestPathForLocation

public TreePath getClosestPathForLocation(int x, int y)

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

Parameters:

Returns:

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

See Also:

getPathForLocation(int, int)
getPathBounds(javax.swing.tree.TreePath)

getClosestRowForLocation

public int getClosestRowForLocation(int x, int y)

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

Parameters:

Returns:

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

See Also:

getRowForLocation(int, int)
getRowBounds(int)

isEditing

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

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

Returns:

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

See Also:

getSelectionPath()

stopEditing

public boolean stopEditing()

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

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

Returns:: true, если редактирование было в процессе и теперь остановлено, false, если редактирование не было в процессе

cancelEditing

public void cancelEditing()

Отменяет текущую сессию редактирования. Не имеет эффекта, если дерево не находится в режиме редактирования.

startEditingAtPath

public void startEditingAtPath(TreePath path)

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

Parameters:: path - the TreePath identifying a node

getEditingPath

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

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

Returns:: the TreePath for the node being edited

setSelectionModel

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

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

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

Parameters:

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

See Also:

TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()

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

Returns:

the model for selections

See Also:

setSelectionModel(javax.swing.tree.TreeSelectionModel)

getPathBetweenRows

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

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

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

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

Parameters:: index0 - первый индекс в диапазоне; index1 - последний индекс в диапазоне
Returns:: пути (включительно) между указанными индексами строк

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 - массив объектов TreePath, определяющих узлы для удаления

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:

EventListenerList

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)

Parameters:

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

See Also:

EventListenerList

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path) throws ExpandVetoException

Parameters:

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

Throws:

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

See Also:

EventListenerList

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path) throws ExpandVetoException

Parameters:

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

Throws:

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

See Also:

EventListenerList

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

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

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

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:

EventListenerList

treeDidChange

public void treeDidChange()

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

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:

JComponent.getPreferredSize()

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:

JScrollBar.setUnitIncrement(int)

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:

JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

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

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

Specified by:

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

Returns:

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

See Also:

Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

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

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

Specified by:

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

Returns:

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

See Also:

Scrollable.getScrollableTracksViewportHeight()

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)

Возвращает список 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 - если includePath 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, 2021, 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/17/docs/api/java.desktop/javax/swing/JTree.html