Класс DefaultMutableTreeNode

java.lang.Object
- javax.swing.tree.DefaultMutableTreeNode

Все реализованные интерфейсы:: Serializable, Cloneable, MutableTreeNode, TreeNode

Прямые известные подклассы:: JTree.DynamicUtilTreeNode

public class DefaultMutableTreeNode
extends Object
implements Cloneable, MutableTreeNode, Serializable

Узел DefaultMutableTreeNode — это узел общего назначения в структуре данных дерева. Примеры использования узлов дерева с изменяемыми свойствами см. в разделе Как использовать деревья в Java Tutorial.

Узел дерева может иметь не более одного родительского узла и 0 или более дочерних узлов. DefaultMutableTreeNode предоставляет операции для проверки и изменения родительского узла и дочерних узлов, а также операции для проверки дерева, частью которого является узел. Дерево узла — это множество всех узлов, которые можно достичь, начав с узла и пройдя все возможные связи к родительским и дочерним узлам. Узел без родительского узла является корнем своего дерева; узел без дочерних узлов является листом. Дерево может состоять из многих поддеревьев, каждый узел выступая в качестве корня для своего поддерева.

Этот класс предоставляет перечисления для эффективного обхода дерева или поддерева в различных порядках или для следования пути между двумя узлами. Узел DefaultMutableTreeNode также может содержать ссылку на пользовательский объект, использование которого остается на усмотрение пользователя. Запрашивая строковое представление DefaultMutableTreeNode с помощью toString(), возвращается строковое представление его пользовательского объекта.

Этот класс не потокобезопасен. Если вы планируете использовать DefaultMutableTreeNode (или дерево узлов TreeNode) в нескольких потоках, вам необходимо выполнить собственную синхронизацию. Хорошей практикой является синхронизация на корневом узле дерева.

Хотя DefaultMutableTreeNode реализует интерфейс MutableTreeNode и позволит вам добавить любое реализацию MutableTreeNode, не все методы в DefaultMutableTreeNode будут применимы ко всем реализациям MutableTreeNodes. Особенно в отношении некоторых перечислений, использование некоторых из этих методов предполагает, что DefaultMutableTreeNode содержит только экземпляры DefaultMutableNode. Все методы TreeNode/MutableTreeNode будут вести себя так, как определено, независимо от добавленных реализаций.

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

См. также:: MutableTreeNode, Сериализованная форма

Поля

Модификатор и тип	Поле	Описание
`protected boolean`	`allowsChildren`	true, если узел может иметь дочерние узлы
`protected Vector<TreeNode>`	`children`	массив дочерних узлов, может быть null, если у этого узла нет дочерних узлов
`static Enumeration<TreeNode>`	`EMPTY_ENUMERATION`	перечисление, которое всегда пустое.
`protected MutableTreeNode`	`parent`	родительский узел этого узла или null, если у этого узла нет родителя
`protected Object`	`userObject`	необязательный пользовательский объект

Конструкторы

Конструктор	Описание
`DefaultMutableTreeNode()`	Создаёт узел дерева без родителя и дочерних узлов, но допускающий наличие дочерних узлов.
`DefaultMutableTreeNode(Object userObject)`	Создаёт узел дерева без родителя, без дочерних узлов, но допускающий наличие дочерних узлов, и инициализирует его указанным пользовательским объектом.
`DefaultMutableTreeNode(Object userObject, boolean allowsChildren)`	Создаёт узел дерева без родителя, без дочерних узлов, инициализированный указанным пользовательским объектом, и допускающий наличие дочерних узлов только если это указано.

Модификатор и тип	Метод	Описание
`void`	`add(MutableTreeNode newChild)`	Удаляет `newChild` из своего родителя и делает его дочерним узлом для этого узла, добавив его в конец массива дочерних узлов этого узла.
`Enumeration<TreeNode>`	`breadthFirstEnumeration()`	Создаёт и возвращает перечисление, которое обходит поддерево, укоренённое в этом узле, в порядке обхода по ширине.
`Enumeration<TreeNode>`	`children()`	Создаёт и возвращает перечисление дочерних узлов этого узла в порядке следования.
`Object`	`clone()`	Переопределено для того, чтобы сделать клонирование публичным.
`Enumeration<TreeNode>`	`depthFirstEnumeration()`	Создаёт и возвращает перечисление, которое обходит поддерево, укоренённое в этом узле, в порядке обхода по глубине.
`boolean`	`getAllowsChildren()`	Возвращает true, если этому узлу разрешено иметь дочерние узлы.
`TreeNode`	`getChildAfter(TreeNode aChild)`	Возвращает дочерний узел в массиве дочерних узлов этого узла, который следует сразу за `aChild`, который должен быть дочерним узлом этого узла.
`TreeNode`	`getChildAt(int index)`	Возвращает дочерний узел по указанному индексу в массиве дочерних узлов этого узла.
`TreeNode`	`getChildBefore(TreeNode aChild)`	Возвращает дочерний узел в массиве дочерних узлов этого узла, который непосредственно предшествует `aChild`, который должен быть дочерним узлом этого узла.
`int`	`getChildCount()`	Возвращает количество дочерних узлов этого узла.
`int`	`getDepth()`	Возвращает глубину дерева, укоренённого в этом узле — наибольшее расстояние от этого узла до листа.
`TreeNode`	`getFirstChild()`	Возвращает первый дочерний узел этого узла.
`DefaultMutableTreeNode`	`getFirstLeaf()`	Находит и возвращает первый лист, являющийся потомком этого узла — либо этот узел, либо первый лист первого дочернего узла.
`int`	`getIndex(TreeNode aChild)`	Возвращает индекс указанного дочернего узла в массиве дочерних узлов этого узла.
`TreeNode`	`getLastChild()`	Возвращает последний дочерний узел этого узла.
`DefaultMutableTreeNode`	`getLastLeaf()`	Находит и возвращает последний лист, являющийся потомком этого узла — либо этот узел, либо последний лист последнего дочернего узла.
`int`	`getLeafCount()`	Возвращает общее количество листов, являющихся потомками этого узла.
`int`	`getLevel()`	Возвращает количество уровней над этим узлом — расстояние от корня до этого узла.
`DefaultMutableTreeNode`	`getNextLeaf()`	Возвращает лист после этого узла или null, если этот узел является последним листом в дереве.
`DefaultMutableTreeNode`	`getNextNode()`	Возвращает узел, следующий за этим узлом при обходе в порядке прямой обхода дерева этого узла.
`DefaultMutableTreeNode`	`getNextSibling()`	Возвращает следующего брата этого узла в массиве дочерних узлов родителя.
`TreeNode`	`getParent()`	Возвращает родителя этого узла или null, если у этого узла нет родителя.
`TreeNode[]`	`getPath()`	Возвращает путь от корня к этому узлу.
`protected TreeNode[]`	`getPathToRoot(TreeNode aNode, int depth)`	Строит родителей узла вплоть до корневого узла включительно, где исходный узел является последним элементом в возвращаемом массиве.
`DefaultMutableTreeNode`	`getPreviousLeaf()`	Возвращает лист перед этим узлом или null, если этот узел является первым листом в дереве.
`DefaultMutableTreeNode`	`getPreviousNode()`	Возвращает узел, который предшествует этому узлу при обходе в порядке прямой обхода дерева этого узла.
`DefaultMutableTreeNode`	`getPreviousSibling()`	Возвращает предыдущего брата этого узла в массиве дочерних узлов родителя.
`TreeNode`	`getRoot()`	Возвращает корень дерева, содержащего этот узел.
`TreeNode`	`getSharedAncestor(DefaultMutableTreeNode aNode)`	Возвращает ближайшего общего предка этого узла и `aNode`.
`int`	`getSiblingCount()`	Возвращает количество братьев/сестер этого узла.
`Object`	`getUserObject()`	Возвращает пользовательский объект этого узла.
`Object[]`	`getUserObjectPath()`	Возвращает путь пользовательского объекта от корня к этому узлу.
`void`	`insert(MutableTreeNode newChild, int childIndex)`	Удаляет `newChild` из его текущего родителя (если у него есть родитель), устанавливает родителя дочернего узла в этот узел, а затем добавляет дочерний узел в массив дочерних узлов этого узла по индексу `childIndex`.
`boolean`	`isLeaf()`	Возвращает true, если у этого узла нет дочерних узлов.
`boolean`	`isNodeAncestor(TreeNode anotherNode)`	Возвращает true, если `anotherNode` является предком этого узла — если это сам узел, родитель этого узла или предок родителя этого узла.
`boolean`	`isNodeChild(TreeNode aNode)`	Возвращает true, если `aNode` является дочерним узлом этого узла.
`boolean`	`isNodeDescendant(DefaultMutableTreeNode anotherNode)`	Возвращает true, если `anotherNode` является потомком этого узла — если это сам узел, один из дочерних узлов этого узла или потомок одного из дочерних узлов этого узла.
`boolean`	`isNodeRelated(DefaultMutableTreeNode aNode)`	Возвращает true, если и только если `aNode` находится в том же дереве, что и этот узел.
`boolean`	`isNodeSibling(TreeNode anotherNode)`	Возвращает true, если `anotherNode` является братом/сестрой этого узла (имеет того же родителя).
`boolean`	`isRoot()`	Возвращает true, если этот узел является корнем дерева.
`Enumeration<TreeNode>`	`pathFromAncestorEnumeration(TreeNode ancestor)`	Создаёт и возвращает перечисление, которое следует по пути от `ancestor` к этому узлу.
`Enumeration<TreeNode>`	`postorderEnumeration()`	Создаёт и возвращает перечисление, которое обходит поддерево, укоренённое в этом узле, в порядке обратного обхода.
`Enumeration<TreeNode>`	`preorderEnumeration()`	Создаёт и возвращает перечисление, которое обходит поддерево, укоренённое в этом узле, в порядке прямого обхода.
`void`	`remove(int childIndex)`	Удаляет дочерний узел по указанному индексу из дочерних узлов этого узла и устанавливает родителя этого узла в null.
`void`	`remove(MutableTreeNode aChild)`	Удаляет `aChild` из массива дочерних узлов этого узла, присваивая ему родителя null.
`void`	`removeAllChildren()`	Удаляет всех дочерних узлов этого узла, устанавливая их родителей в null.
`void`	`removeFromParent()`	Удаляет поддерево, укоренённое в этом узле, из дерева, присваивая этому узлу родителя null.
`void`	`setAllowsChildren(boolean allows)`	Определяет, разрешено ли этому узлу иметь дочерние узлы.
`void`	`setParent(MutableTreeNode newParent)`	Устанавливает родителя этого узла в `newParent`, но не изменяет массив дочерних узлов родителя.
`void`	`setUserObject(Object userObject)`	Устанавливает пользовательский объект этого узла в `userObject`.
`String`	`toString()`	Возвращает результат отправки `toString()` в пользовательский объект этого узла или пустую строку, если у узла нет пользовательского объекта.

Класс DefaultMutableTreeNode

Поля

Конструкторы

Методы

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

Поля

EMPTY_ENUMERATION

parent

children

userObject

allowsChildren

Конструкторы

DefaultMutableTreeNode

DefaultMutableTreeNode

DefaultMutableTreeNode

Методы

insert

remove

setParent

getParent

getChildAt

getChildCount

getIndex

children

setAllowsChildren

getAllowsChildren

setUserObject

getUserObject

removeFromParent

remove

removeAllChildren

add

isNodeAncestor

isNodeDescendant

getSharedAncestor

isNodeRelated

getDepth

getLevel

getPath

getPathToRoot

getUserObjectPath

getRoot

isRoot

getNextNode

getPreviousNode

preorderEnumeration

postorderEnumeration

breadthFirstEnumeration

depthFirstEnumeration

pathFromAncestorEnumeration

isNodeChild

getFirstChild

getLastChild

getChildAfter

getChildBefore

isNodeSibling

getSiblingCount

getNextSibling

getPreviousSibling

isLeaf

getFirstLeaf

getLastLeaf

getNextLeaf

getPreviousLeaf

getLeafCount

toString

clone