Класс JTree

java.lang.Object
- java.awt.Component
- - java.awt.Container
  - - javax.swing.JComponent
    - - javax.swing.JTree

Все реализованные интерфейсы:: ImageObserver, MenuContainer, Serializable, Accessible, Scrollable

public class JTree
extends JComponent
implements Scrollable, Accessible

Элемент управления, отображающий набор иерархических данных в виде наброска. Документацию и примеры использования деревьев можно найти в Разделе "Использование деревьев" в 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.

Вложенные классы

Модификатор и тип	Класс и описание
`protected class`	`JTree.AccessibleJTree` Этот класс реализует поддержку доступности для класса `JTree`.
`static 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 String`	`ANCHOR_SELECTION_PATH_PROPERTY` Имя привязанного свойства для пути выделения якоря.
`static String`	`CELL_EDITOR_PROPERTY` Имя привязанного свойства для `cellEditor`.
`static String`	`CELL_RENDERER_PROPERTY` Имя привязанного свойства для `cellRenderer`.
`protected TreeCellEditor`	`cellEditor` Редактор для записей.
`protected TreeCellRenderer`	`cellRenderer` Ячейка, используемая для рисования узлов.
`protected boolean`	`editable` Является ли дерево редактируемым? По умолчанию false.
`static String`	`EDITABLE_PROPERTY` Имя привязанного свойства для `editable`.
`static String`	`EXPANDS_SELECTED_PATHS_PROPERTY` Свойство, определяющее расширенные выделенные пути
`static String`	`INVOKES_STOP_CELL_EDITING_PROPERTY` Имя привязанного свойства для `messagesStopCellEditing`.
`protected boolean`	`invokesStopCellEditing` Если true, при прекращении редактирования путем изменения выделения, изменения в дереве или другими способами `stopCellEditing` вызывается, а изменения сохраняются.
`static String`	`LARGE_MODEL_PROPERTY` Имя привязанного свойства для `largeModel`.
`protected boolean`	`largeModel` Является ли это дерево большой моделью? Это настройка для оптимизации кода.
`static String`	`LEAD_SELECTION_PATH_PROPERTY` Имя привязанного свойства для `leadSelectionPath`.
`static String`	`ROOT_VISIBLE_PROPERTY` Имя привязанного свойства для `rootVisible`.
`protected boolean`	`rootVisible` Истина, если корневой узел отображается, ложь, если его дочерние узлы являются наиболее видимыми узлами.
`static String`	`ROW_HEIGHT_PROPERTY` Имя привязанного свойства для `rowHeight`.
`protected int`	`rowHeight` Высота для каждой строки отображения.
`static String`	`SCROLLS_ON_EXPAND_PROPERTY` Имя привязанного свойства для `scrollsOnExpand`.
`protected boolean`	`scrollsOnExpand` Если true, при расширении узла, как можно больше потомков прокручиваются, чтобы стать видимыми.
`static String`	`SELECTION_MODEL_PROPERTY` Имя привязанного свойства для selectionModel.
`protected TreeSelectionModel`	`selectionModel` Модель набора выделенных узлов в этом дереве.
`protected JTree.TreeSelectionRedirector`	`selectionRedirector` Создаёт новое событие и передает его `selectionListeners`.
`static String`	`SHOWS_ROOT_HANDLES_PROPERTY` Имя привязанного свойства для `showsRootHandles`.
`protected boolean`	`showsRootHandles` Истина, если маркеры отображаются на самом верхнем уровне дерева.
`static String`	`TOGGLE_CLICK_COUNT_PROPERTY` Имя привязанного свойства для `toggleClickCount`.
`protected int`	`toggleClickCount` Количество щелчков мышью перед расширением узла.
`static String`	`TREE_MODEL_PROPERTY` Имя привязанного свойства для `treeModel`.
`protected TreeModel`	`treeModel` Модель, определяющая дерево, отображаемое этим объектом.
`protected TreeModelListener`	`treeModelListener` Обновляет `expandedState`.
`static 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(Hashtable<?,?> value)` Возвращает `JTree` , созданный из `Hashtable` , который не отображается с корнем.
`JTree(Object[] value)` Возвращает `JTree` , где каждый элемент указанного массива является потомком нового корневого узла, который не отображается.
`JTree(TreeModel newModel)` Возвращает экземпляр `JTree` , который отображает корневой узел — дерево создаётся с использованием указанной модели данных.
`JTree(TreeNode root)` Возвращает `JTree` с указанным `TreeNode` в качестве корня, который отображает корневой узел.
`JTree(TreeNode root, boolean asksAllowsChildren)` Возвращает `JTree` с указанным `TreeNode` в качестве корня, который отображает корневой узел и определяет, является ли узел листом, в соответствии со спецификацией.
`JTree(Vector<?> value)` Возвращает `JTree` , где каждый элемент указанного `Vector` является потомком нового корневого узла, который не отображается.

Методы

Модификатор и тип	Метод и описание
`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()` Возвращает, включено ли автоматическое управление перетаскиванием.
`JTree.DropLocation`	`getDropLocation()` Возвращает расположение, которое этот компонент должен визуально указывать как место падения во время операции перетаскивания над компонентом, или `null`, если расположение не должно отображаться.
`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)` Включает или выключает автоматическую обработку перетаскивания.
`void`	`setDropMode(DropMode dropMode)` Устанавливает режим выгрузки для этого компонента.
`void`	`setEditable(boolean flag)` Определяет, редактируется ли дерево.
`protected void`	`setExpandedState(TreePath path, boolean state)` Устанавливает состояние развертывания этого `JTree`.
`void`	`setExpandsSelectedPaths(boolean newValue)` Настраивает свойство `expandsSelectedPaths`.
`void`	`setInvokesStopCellEditing(boolean newValue)` Определяет, что произойдет при прерывании редактирования выбором другого узла в дереве, изменении данных дерева или по другим причинам.
`void`	`setLargeModel(boolean newValue)` Указывает, должен ли интерфейс пользователя использовать большую модель.
`void`	`setLeadSelectionPath(TreePath newPath)` Устанавливает путь, идентифицированный как ведущий.
`void`	`setModel(TreeModel newModel)` Устанавливает `TreeModel`, который будет предоставлять данные.
`void`	`setRootVisible(boolean rootVisible)` Определяет, отображается ли корневой узел из `TreeModel`.
`void`	`setRowHeight(int rowHeight)` Устанавливает высоту каждой ячейки в пикселях.
`void`	`setScrollsOnExpand(boolean newValue)` Устанавливает свойство `scrollsOnExpand`, которое определяет, может ли дерево прокручиваться, чтобы показать ранее скрытые дочерние элементы.
`void`	`setSelectionInterval(int index0, int index1)` Выбирает строки в указанном интервале (включительно).
`void`	`setSelectionModel(TreeSelectionModel selectionModel)` Устанавливает модель выбора дерева.
`void`	`setSelectionPath(TreePath path)` Выбирает узел, идентифицированный указанным путем.
`void`	`setSelectionPaths(TreePath[] paths)` Выбирает узлы, идентифицированные указанным массивом путей.
`void`	`setSelectionRow(int row)` Выбирает узел в указанной строке в области отображения.
`void`	`setSelectionRows(int[] rows)` Выбирает узлы, соответствующие каждой из указанных строк в области отображения.
`void`	`setShowsRootHandles(boolean newValue)` Устанавливает значение свойства `showsRootHandles`, которое определяет, должны ли отображаться узловые маркеры.
`void`	`setToggleClickCount(int clickCount)` Устанавливает количество щелчков мышью перед развертыванием или закрытием узла.
`void`	`setUI(TreeUI ui)` Устанавливает объект L&F, который отображает этот компонент.
`void`	`setVisibleRowCount(int newCount)` Устанавливает количество отображаемых строк.
`void`	`startEditingAtPath(TreePath path)` Выбирает узел, идентифицированный указанным путем, и начинает редактирование.
`boolean`	`stopEditing()` Завершает текущую сессию редактирования.
`void`	`treeDidChange()` Отправляется, когда дерево изменилось достаточно, чтобы потребовалось изменить границы, но недостаточно, чтобы потребовалось удалить набор развернутых узлов (например, узлы были развернуты или свёрнуты, или узлы были вставлены в дерево).
`void`	`updateUI()` Уведомление от `UIManager` о том, что L&F изменился.

Methods inherited from class javax.swing.JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class java.awt.Container

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

Methods inherited from class java.awt.Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPeer, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from 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

Если true, при остановке редактирования путем изменения выбора, изменения данных в дереве или другими способами вызывается stopCellEditing, и изменения сохраняются. Если false, вызывается 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(value="model")
public JTree(TreeModel newModel)

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

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

Методы

getDefaultTreeModel

protected static TreeModel getDefaultTreeModel()

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

Возвращает:: стандартную TreeModel

createTreeModel

protected static TreeModel createTreeModel(Object value)

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

массивом Object,
Hashtable, или
Vector

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

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

getUI

public TreeUI getUI()

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

Возвращает:: объект TreeUI, который отрисовывает этот компонент

setUI

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

public String getUIClassID()

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

Переопределяет:: getUIClassID в классе JComponent
Возвращает:: строку "TreeUI"
См. также:: JComponent.getUIClassID(), UIDefaults.getUI(javax.swing.JComponent)

getCellRenderer

public TreeCellRenderer getCellRenderer()

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

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

setCellRenderer

public void setCellRenderer(TreeCellRenderer x)

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

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

Параметры:: x - TreeCellRenderer, который должен отрисовывать каждую ячейку

setEditable

public void setEditable(boolean flag)

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

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

Параметры:: flag - булевое значение, true, если дерево редактируемо

isEditable

public boolean isEditable()

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

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

setCellEditor

public void setCellEditor(TreeCellEditor cellEditor)

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

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

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

getCellEditor

public TreeCellEditor getCellEditor()

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

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

getModel

public TreeModel getModel()

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

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

setModel

public void setModel(TreeModel newModel)

Устанавливает TreeModel, который предоставит данные.

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

Параметры:: newModel - TreeModel, который должен предоставить данные

isRootVisible

public boolean isRootVisible()

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

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

setRootVisible

public void setRootVisible(boolean rootVisible)

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

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

Параметры:: rootVisible - true, если корневой узел дерева должен отображаться
См. также:: rootVisible

setShowsRootHandles

public void setShowsRootHandles(boolean newValue)

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

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

Параметры:: newValue - true, если маркеры корня должны отображаться; в противном случае, false
См. также:: showsRootHandles, getShowsRootHandles()

getShowsRootHandles

public boolean getShowsRootHandles()

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

Возвращает:: значение свойства showsRootHandles
См. также:: showsRootHandles

setRowHeight

public void setRowHeight(int rowHeight)

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

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

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

getRowHeight

public int getRowHeight()

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

isFixedRowHeight

public boolean isFixedRowHeight()

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

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

setLargeModel

public void setLargeModel(boolean newValue)

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

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

Параметры:: newValue - true, чтобы предложить интерфейсу использовать большую модель
См. также:: largeModel

isLargeModel

public boolean isLargeModel()

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

Возвращает:: true, если предполагается большая модель
См. также:: largeModel

setInvokesStopCellEditing

public void setInvokesStopCellEditing(boolean newValue)

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

Вызывает событие изменения свойства для INVOKES_STOP_CELL_EDITING_PROPERTY.

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

getInvokesStopCellEditing

public boolean getInvokesStopCellEditing()

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

Возвращает:: индикатор, показывающий, что происходит при прерывании редактирования
См. также:: setInvokesStopCellEditing(boolean)

setScrollsOnExpand

public void setScrollsOnExpand(boolean newValue)

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

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

Параметры:: newValue - false для отключения прокрутки при раскрытии; true для включения
См. также:: getScrollsOnExpand()

getScrollsOnExpand

public boolean getScrollsOnExpand()

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

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

setToggleClickCount

public void setToggleClickCount(int clickCount)

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

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

С:: 1.3

getToggleClickCount

public int getToggleClickCount()

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

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

setExpandsSelectedPaths

public void setExpandsSelectedPaths(boolean newValue)

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

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

Параметры:: newValue - новое значение для expandsSelectedPaths
С:: 1.3

getExpandsSelectedPaths

public boolean getExpandsSelectedPaths()

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

Возвращает:: true, если изменение выделения приводит к раскрытию родительского пути
С:: 1.3
См. также:: setExpandsSelectedPaths(boolean)

setDragEnabled

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
См. также:: GraphicsEnvironment.isHeadless(), getDragEnabled(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDragEnabled

public boolean getDragEnabled()

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

Возвращает:: значение свойства dragEnabled
С:: 1.4
См. также:: setDragEnabled(boolean)

setDropMode

public final void setDropMode(DropMode dropMode)

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

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

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

Режим размещения имеет смысл только если у этого компонента есть TransferHandler , который принимает размещение.

Параметры:: dropMode - режим размещения
Исключения:: IllegalArgumentException - если режим размещения не поддерживается или null
С:: 1.6
См. также:: getDropMode(), getDropLocation(), JComponent.setTransferHandler(javax.swing.TransferHandler), TransferHandler

getDropMode

public final DropMode getDropMode()

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

Возвращает:: режим размещения для этого компонента
С:: 1.6
См. также:: setDropMode(javax.swing.DropMode)

getDropLocation

public final JTree.DropLocation getDropLocation()

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

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

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

Возвращает:: местоположение размещения
С:: 1.6
См. также:: setDropMode(javax.swing.DropMode), TransferHandler.canImport(TransferHandler.TransferSupport)

isPathEditable

public boolean isPathEditable(TreePath path)

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

Возвращает:: true, если каждый родительский узел и сам узел могут быть отредактированы
См. также:: isEditable()

getToolTipText

public String getToolTipText(MouseEvent event)

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

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

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

convertValueToText

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

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

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

getRowCount

public int getRowCount()

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

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

setSelectionPath

public void setSelectionPath(TreePath path)

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

Параметры:: path - TreePath , определяющий узел для выделения

setSelectionPaths

public void setSelectionPaths(TreePath[] paths)

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

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

setLeadSelectionPath

public void setLeadSelectionPath(TreePath newPath)

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

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

Параметры:: newPath - новый ведущий путь
С:: 1.3

setAnchorSelectionPath

public void setAnchorSelectionPath(TreePath newPath)

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

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

Параметры:: newPath - новый якорный путь
С:: 1.3

setSelectionRow

public void setSelectionRow(int row)

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

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

setSelectionRows

public void setSelectionRows(int[] rows)

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

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

addSelectionPath

public void addSelectionPath(TreePath path)

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

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

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

public Object getLastSelectedPathComponent()

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

Returns:: последний компонент пути выделенного пути или null, если ничего не выбрано
See Also:: TreePath.getLastPathComponent()

getLeadSelectionPath

public TreePath getLeadSelectionPath()

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

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

getAnchorSelectionPath

public TreePath getAnchorSelectionPath()

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

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

getSelectionPath

public TreePath getSelectionPath()

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

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

getSelectionPaths

public TreePath[] getSelectionPaths()

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

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

getSelectionRows

public int[] getSelectionRows()

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

Returns:: массив целых чисел, идентифицирующих все текущие выделенные строки, где 0 — первая строка в представлении

getSelectionCount

public int getSelectionCount()

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

Returns:: количество выделенных узлов

getMinSelectionRow

public int getMinSelectionRow()

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

Returns:: наименьшая выделенная строка

getMaxSelectionRow

public int getMaxSelectionRow()

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

Returns:: наибольшая выделенная строка

getLeadSelectionRow

public int getLeadSelectionRow()

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

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

isPathSelected

public boolean isPathSelected(TreePath path)

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

Parameters:: path - TreePath , определяющий узел
Returns:: true, если узел выделен

isRowSelected

public boolean isRowSelected(int row)

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

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

getExpandedDescendants

public Enumeration<TreePath> getExpandedDescendants(TreePath parent)

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

Parameters:: parent - путь, который должен быть проверен
Returns:: Enumeration потомков parent, или null если parent не развернут в данный момент

hasBeenExpanded

public boolean hasBeenExpanded(TreePath path)

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

Returns:: true, если узел path когда-либо был развернут

isExpanded

public boolean isExpanded(TreePath path)

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

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

isExpanded

public boolean isExpanded(int row)

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

Parameters:: row - строка для проверки, где 0 — первая строка в представлении
Returns:: true, если узел в данный момент развернут, в противном случае false

isCollapsed

public boolean isCollapsed(TreePath path)

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

Parameters:: path - TreePath для проверки
Returns:: true, если какой-либо из узлов в пути узла свёрнут, false, если все узлы в пути развернуты

isCollapsed

public boolean isCollapsed(int row)

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

Parameters:: row - строка для проверки, где 0 — первая строка в представлении
Returns:: true, если узел в данный момент свёрнут, в противном случае false

makeVisible

public void makeVisible(TreePath path)

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

Parameters:: path - TreePath для отображения

isVisible

public boolean isVisible(TreePath path)

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

Returns:: true, если узел отображается, в противном случае false

getPathBounds

public Rectangle getPathBounds(TreePath path)

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

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

Parameters:: path - TreePath , определяющий узел
Returns:: Rectangle , в котором нарисован узел, или null

getRowBounds

public Rectangle getRowBounds(int row)

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

Parameters:: row - строка для рисования, где 0 — первая строка в представлении
Returns:: Rectangle , в котором нарисован узел

scrollPathToVisible

public void scrollPathToVisible(TreePath path)

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

Parameters:: path - TreePath , определяющий узел, который нужно отобразить

scrollRowToVisible

public void scrollRowToVisible(int row)

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

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

getPathForRow

public TreePath getPathForRow(int row)

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

Parameters:: row - целое число, определяющее строку
Returns:: TreePath до указанного узла, null если row < 0 или row >= getRowCount()

getRowForPath

public int getRowForPath(TreePath path)

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

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

expandPath

public void expandPath(TreePath path)

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

Параметры:: path - TreePath, определяющий узел

expandRow

public void expandRow(int row)

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

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

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

collapsePath

public void collapsePath(TreePath path)

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

Параметры:: path - TreePath, определяющий узел

collapseRow

public void collapseRow(int row)

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

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

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

getPathForLocation

public TreePath getPathForLocation(int x,
                                   int y)

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

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

getRowForLocation

public int getRowForLocation(int x,
                             int y)

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

Параметры:: x - целое число, представляющее количество пикселей по горизонтали от левого края области отображения, за вычетом левой отступы; y - целое число, представляющее количество пикселей по вертикали от верхней границы области отображения, за вычетом верхней отступы
Возвращает:: строку, соответствующую местоположению, или -1, если местоположение не находится в пределах видимой ячейки
См. также:: getClosestRowForLocation(int, int)

getClosestPathForLocation

public TreePath getClosestPathForLocation(int x,
                                          int y)

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

Параметры:: x - целое число, представляющее количество пикселей по горизонтали от левого края области отображения, за вычетом левой отступы; y - целое число, представляющее количество пикселей по вертикали от верхней границы области отображения, за вычетом верхней отступы
Возвращает:: путь к узлу, ближайшему к этому местоположению, null, если ничего не видно или нет модели
См. также:: getPathForLocation(int, int), getPathBounds(javax.swing.tree.TreePath)

getClosestRowForLocation

public int getClosestRowForLocation(int x,
                                    int y)

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

Параметры:: x - целое число, представляющее количество пикселей по горизонтали от левого края области отображения, за вычетом левой отступы; y - целое число, представляющее количество пикселей по вертикали от верхней границы области отображения, за вычетом верхней отступы
Возвращает:: строку, ближайшую к местоположению, -1, если ничего не видно или нет модели
См. также:: getRowForLocation(int, int), getRowBounds(int)

isEditing

public boolean isEditing()

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

Возвращает:: true, если пользователь в данный момент редактирует узел
См. также:: getSelectionPath()

stopEditing

public boolean stopEditing()

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

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

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

cancelEditing

public void cancelEditing()

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

startEditingAtPath

public void startEditingAtPath(TreePath path)

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

Параметры:: path - TreePath, определяющий узел

getEditingPath

public TreePath getEditingPath()

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

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

setSelectionModel

public void setSelectionModel(TreeSelectionModel selectionModel)

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

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

Параметры:: selectionModel - модель TreeSelectionModel для использования, или null для отключения выделений
См. также:: TreeSelectionModel

getSelectionModel

public TreeSelectionModel getSelectionModel()

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

См. также:: 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, или указанные индексы не ограничивают набор отображаемых строк.

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

setSelectionInterval

public void setSelectionInterval(int index0,
                                 int index1)

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

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

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

addSelectionInterval

public void addSelectionInterval(int index0,
                                 int index1)

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

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

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

removeSelectionInterval

public void removeSelectionInterval(int index0,
                                    int index1)

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

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

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

removeSelectionPath

public void removeSelectionPath(TreePath path)

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

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

removeSelectionPaths

public void removeSelectionPaths(TreePath[] paths)

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

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

removeSelectionRow

public void removeSelectionRow(int row)

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

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

removeSelectionRows

public void removeSelectionRows(int[] rows)

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

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

clearSelection

public void clearSelection()

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

isSelectionEmpty

public boolean isSelectionEmpty()

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

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

addTreeExpansionListener

public void addTreeExpansionListener(TreeExpansionListener tel)

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

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

removeTreeExpansionListener

public void removeTreeExpansionListener(TreeExpansionListener tel)

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

Параметры:: tel - слушатель для удаления

getTreeExpansionListeners

public TreeExpansionListener[] getTreeExpansionListeners()

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

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

addTreeWillExpandListener

public void addTreeWillExpandListener(TreeWillExpandListener tel)

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

Параметры:: tel - слушатель, который будет уведомлен, когда узел дерева будет раскрыт или свернут (отрицательное раскрытие)

removeTreeWillExpandListener

public void removeTreeWillExpandListener(TreeWillExpandListener tel)

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

Параметры:: tel - слушатель для удаления

getTreeWillExpandListeners

public TreeWillExpandListener[] getTreeWillExpandListeners()

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

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

fireTreeExpanded

public void fireTreeExpanded(TreePath path)

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

Параметры:: path - путь, указывающий на узел, который был раскрыт
См. также:: EventListenerList

fireTreeCollapsed

public void fireTreeCollapsed(TreePath path)

Параметры:: path - путь, указывающий на узел, который был свёрнут
См. также:: EventListenerList

fireTreeWillExpand

public void fireTreeWillExpand(TreePath path)
                        throws ExpandVetoException

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

fireTreeWillCollapse

public void fireTreeWillCollapse(TreePath path)
                          throws ExpandVetoException

Параметры:: path - путь, указывающий на узел, который будет свёрнут
Исключения:: ExpandVetoException
См. также:: EventListenerList

addTreeSelectionListener

public void addTreeSelectionListener(TreeSelectionListener tsl)

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

Параметры:: tsl - слушатель, который будет уведомлён, когда узел выбран или отменён (отрицательный выбор)

removeTreeSelectionListener

public void removeTreeSelectionListener(TreeSelectionListener tsl)

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

Параметры:: tsl - слушатель для удаления

getTreeSelectionListeners

public TreeSelectionListener[] getTreeSelectionListeners()

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

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

fireValueChanged

protected void fireValueChanged(TreeSelectionEvent e)

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

Параметры:: e - событие, которое должно быть отправлено; генерируется TreeSelectionModel, когда узел выбран или отменён
См. также:: EventListenerList

treeDidChange

public void treeDidChange()

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

setVisibleRowCount

public void setVisibleRowCount(int newCount)

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

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

Параметры:: newCount - количество строк для отображения

getVisibleRowCount

public int getVisibleRowCount()

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

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

getNextMatch

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

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

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

getPreferredScrollableViewportSize

public Dimension getPreferredScrollableViewportSize()

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

Определяется в:: getPreferredScrollableViewportSize в интерфейсе Scrollable
Возвращает:: объект Dimension, содержащий предпочтительный размер
См. также:: JComponent.getPreferredSize()

getScrollableUnitIncrement

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

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

Указано в:: getScrollableUnitIncrement в интерфейсе Scrollable
Параметры:: visibleRect - область просмотра, видимая в окне просмотра; orientation - либо SwingConstants.VERTICAL , либо SwingConstants.HORIZONTAL; direction - меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо
Возвращает:: приращение "единицы" для прокрутки в указанном направлении
См. также:: JScrollBar.setUnitIncrement(int)

getScrollableBlockIncrement

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

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

Указано в:: getScrollableBlockIncrement в интерфейсе Scrollable
Параметры:: visibleRect - область просмотра, видимая в окне просмотра; orientation - либо SwingConstants.VERTICAL , либо SwingConstants.HORIZONTAL; direction - меньше нуля для прокрутки вверх/влево, больше нуля для прокрутки вниз/вправо.
Возвращает:: приращение "блока" для прокрутки в указанном направлении
См. также:: JScrollBar.setBlockIncrement(int)

getScrollableTracksViewportWidth

public boolean getScrollableTracksViewportWidth()

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

Указано в:: getScrollableTracksViewportWidth в интерфейсе Scrollable
Возвращает:: следует ли дереву отслеживать ширину области просмотра
См. также:: Scrollable.getScrollableTracksViewportWidth()

getScrollableTracksViewportHeight

public boolean getScrollableTracksViewportHeight()

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

Указано в:: getScrollableTracksViewportHeight в интерфейсе Scrollable
Возвращает:: следует ли дереву отслеживать высоту области просмотра
См. также:: Scrollable.getScrollableTracksViewportHeight()

setExpandedState

protected void setExpandedState(TreePath path,
                                boolean state)

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

Это может не сработать, если TreeWillExpandListener запретит это.

getDescendantToggledPaths

protected Enumeration<TreePath> getDescendantToggledPaths(TreePath parent)

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

removeDescendantToggledPaths

protected void removeDescendantToggledPaths(Enumeration<TreePath> toRemove)

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

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

clearToggledPaths

protected void clearToggledPaths()

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

createTreeModelListener

protected TreeModelListener createTreeModelListener()

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

Для получения дополнительной информации о значении состояния развертывания см. описание JTree выше.

removeDescendantSelectedPaths

protected boolean removeDescendantSelectedPaths(TreePath path,
                                                boolean includePath)

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

Возвращает:: true, если потомки были выделены
С:: 1.3

paramString

protected String paramString()

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

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

getAccessibleContext

public AccessibleContext getAccessibleContext()

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

Указано в:: getAccessibleContext в интерфейсе Accessible
Переопределяет:: getAccessibleContext в классе Component
Возвращает:: AccessibleJTree, который служит AccessibleContext для этого JTree

© 1993, 2020, 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.