Класс DefaultTreeModel
- Все реализуемые интерфейсы:
Serializable, TreeModel
public class DefaultTreeModel extends Object implements Serializable, TreeModel
Предупреждение: Сериализованные объекты этого класса будут несовместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, поддержка долговременного хранения всех JavaBeans добавлена в пакет java.beans. См. XMLEncoder.
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
protected boolean |
asksAllowsChildren |
Определяет, как метод isLeaf определяет, является ли узел листовым. |
protected EventListenerList |
listenerList |
Слушатели. |
protected TreeNode |
root |
Корень дерева. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
DefaultTreeModel |
Создает дерево, в котором любой узел может иметь дочерние узлы. |
DefaultTreeModel |
Создает дерево, задавая, может ли любой узел иметь дочерние узлы или только некоторые узлы могут иметь дочерние узлы. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addTreeModelListener |
Добавляет слушателя для TreeModelEvent, отправляемого после изменения дерева. |
boolean |
asksAllowsChildren() |
Указывает, как определяются листовые узлы. |
protected void |
fireTreeNodesChanged |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
protected void |
fireTreeNodesInserted |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
protected void |
fireTreeNodesRemoved |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
protected void |
fireTreeStructureChanged |
Уведомляет всех слушателей, зарегистрировавших интерес к уведомлениям о событиях этого типа. |
Object |
getChild |
Возвращает дочерний узел parent с индексом index в массиве дочерних узлов родительского узла. |
int |
getChildCount |
Возвращает количество дочерних узлов у parent. |
int |
getIndexOfChild |
Возвращает индекс дочернего узла в родительском узле. |
<T extends EventListener> |
getListeners |
Возвращает массив всех объектов, зарегистрированных в этой модели в качестве FooListeners. |
TreeNode[] |
getPathToRoot |
Формирует список родительских узлов node вплоть до корневого узла включительно; исходный узел является последним элементом возвращаемого массива. |
protected TreeNode[] |
getPathToRoot |
Формирует список родительских узлов node вплоть до корневого узла включительно; исходный узел является последним элементом возвращаемого массива. |
Object |
getRoot() |
Возвращает корень дерева. |
TreeModelListener[] |
getTreeModelListeners() |
Возвращает массив всех слушателей модели дерева, зарегистрированных в этой модели. |
void |
insertNodeInto |
Вызовите этот метод, чтобы вставить newChild в дочерние узлы родительского узла на позицию index. |
boolean |
isLeaf |
Возвращает, является ли указанный узел листовым. |
void |
nodeChanged |
Вызовите этот метод после изменения способа представления узла в дереве. |
void |
nodesChanged |
Вызовите этот метод после изменения способа представления в дереве дочерних узлов, указанных в childIndices. |
void |
nodeStructureChanged |
Вызовите этот метод, если вы полностью изменили дочерние узлы node и дочерние узлы этих узлов... |
void |
nodesWereInserted |
Вызовите этот метод после вставки нескольких TreeNodes в node. |
void |
nodesWereRemoved |
Вызовите этот метод после удаления нескольких TreeNodes из node. |
void |
reload() |
Вызовите этот метод, если вы изменили TreeNodes, от которых зависит эта модель. |
void |
reload |
Вызовите этот метод, если вы изменили TreeNodes, от которых зависит эта модель. |
void |
removeNodeFromParent |
Вызовите этот метод, чтобы удалить узел из его родительского узла. |
void |
removeTreeModelListener |
Удаляет слушателя, ранее добавленного с помощью addTreeModelListener(). |
void |
setAsksAllowsChildren |
Задает, следует ли проверять, является ли узел листовым, вызывая у TreeNodes getAllowsChildren() или isLeaf(). |
void |
setRoot |
Задает корень равным root. |
void |
valueForPathChanged |
Задает пользовательский объект TreeNode, определенного путем, и отправляет событие об изменении узла. |
Методы, объявленные в классе Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait | Модификатор и тип | Метод | Описание |
|---|---|---|
protected Object |
clone() |
Создает и возвращает копию этого объекта. |
boolean |
equals |
Указывает, равен ли этот объект какому-либо другому объекту. |
protected void |
finalize() |
Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация объявлена устаревшей и подлежит удалению в одном из будущих выпусков. |
final Class |
getClass() |
Возвращает класс времени выполнения этого Object. |
int |
hashCode() |
Возвращает значение хеш-кода этого объекта. |
final void |
notify() |
Пробуждает один поток, ожидающий на мониторе этого объекта. |
final void |
notifyAll() |
Пробуждает все потоки, ожидающие на мониторе этого объекта. |
String |
toString() |
Возвращает строковое представление объекта. |
final void |
wait() |
Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt. |
final void |
wait |
Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
final void |
wait |
Приостанавливает текущий поток до его пробуждения, обычно в результате вызова notify или interrupt, либо до истечения заданного промежутка реального времени. |
Подробное описание полей
root
protected TreeNode root
listenerList
protected EventListenerList listenerList
asksAllowsChildren
protected boolean asksAllowsChildren
isLeaf выясняет, является ли узел листовым. Если значение равно true, узел считается листовым, если он не допускает дочерние узлы. (Если он допускает дочерние узлы, он не является листовым, даже если у него нет дочерних узлов.) Это позволяет, например, различать узлы папок и файлов в файловой системе. Если это значение равно false, любой узел без дочерних узлов считается листовым, и у любого узла могут появиться дочерние узлы.
- См. также:
Подробное описание конструкторов
DefaultTreeModel
@ConstructorProperties("root") public DefaultTreeModel(TreeNode root) - Параметры:
-
root— объект TreeNode, являющийся корнем дерева - См. также:
DefaultTreeModel
public DefaultTreeModel(TreeNode root, boolean asksAllowsChildren)
- Параметры:
-
root— объект TreeNode, являющийся корнем дерева -
asksAllowsChildren— значение boolean: false, если у любого узла могут быть дочерние узлы; true, если у каждого узла проверяется, могут ли у него быть дочерние узлы - См. также:
Подробное описание методов
setAsksAllowsChildren
public void setAsksAllowsChildren(boolean newValue)
- Параметры:
-
newValue— если true, вызывается getAllowsChildren(), в противном случае — isLeaf()
asksAllowsChildren
public boolean asksAllowsChildren()
- Возвращает:
- true, если листовыми считаются только узлы, не допускающие дочерние узлы; false, если листовыми считаются узлы без дочерних узлов (даже если дочерние узлы разрешены)
- См. также:
setRoot
public void setRoot(TreeNode root)
root. Значение null для root означает, что дерево не должно отображать ничего; это допустимо.- Параметры:
-
root— новое значение корня дерева
getRoot
getIndexOfChild
public int getIndexOfChild(Object parent, Object child)
null, возвращает -1.- Определено в:
-
getIndexOfChildв интерфейсеTreeModel - Параметры:
-
parent— узел дерева, полученный из этого источника данных -
child— интересующий нас узел - Возвращает:
- индекс дочернего узла в родительском или -1, если родительский или дочерний узел равен
null
getChild
public Object getChild(Object parent, int index)
getChildCount
public int getChildCount(Object parent)
- Определено в:
-
getChildCountв интерфейсеTreeModel - Параметры:
-
parent— узел дерева, полученный из этого источника данных - Возвращает:
- количество дочерних узлов родительского узла parent
isLeaf
reload
public void reload()
TreeNode, от которых зависит эта модель. Модель уведомит всех своих слушателей об изменении модели.valueForPathChanged
public void valueForPathChanged(TreePath path, Object newValue)
- Определено в:
-
valueForPathChangedв интерфейсеTreeModel - Параметры:
-
path— путь к узлу, измененному пользователем -
newValue— новое значение из TreeCellEditor
insertNodeInto
public void insertNodeInto(MutableTreeNode newChild, MutableTreeNode parent, int index)
- Параметры:
-
newChild— вставляемый дочерний узел -
parent— узел, в который будет добавлен новый дочерний узел -
index— индекс среди дочерних узлов родительского узла
removeNodeFromParent
public void removeNodeFromParent(MutableTreeNode node)
- Параметры:
-
node— узел, который нужно удалить из родительского узла
nodeChanged
public void nodeChanged(TreeNode node)
- Параметры:
-
node— измененный узел
reload
public void reload(TreeNode node)
TreeNode, от которых зависит эта модель. Модель уведомит всех своих слушателей об изменении модели ниже указанного узла.- Параметры:
-
node— узел, ниже которого изменилась модель
nodesWereInserted
public void nodesWereInserted(TreeNode node, int[] childIndices)
- Параметры:
-
node— родительский узел, количество дочерних узлов которого увеличилось -
childIndices— индексы вставленных дочерних узлов
nodesWereRemoved
public void nodesWereRemoved(TreeNode node, int[] childIndices, Object[] removedChildren)
- Параметры:
-
node— родительский узел, из которого были удалены дочерние узлы -
childIndices— индексы удаленных дочерних узлов -
removedChildren— массив удаленных дочерних объектов
nodesChanged
public void nodesChanged(TreeNode node, int[] childIndices)
- Параметры:
-
node— измененный узел -
childIndices— индексы измененных дочерних узлов
nodeStructureChanged
public void nodeStructureChanged(TreeNode node)
- Параметры:
-
node— измененный узел
getPathToRoot
public TreeNode[] getPathToRoot(TreeNode aNode)
- Параметры:
-
aNode— TreeNode, для которого нужно получить путь - Возвращает:
- массив TreeNode, задающий путь от корня
getPathToRoot
protected TreeNode[] getPathToRoot(TreeNode aNode, int depth)
- Параметры:
-
aNode— TreeNode, для которого нужно получить путь -
depth— число int, задающее количество шагов, уже пройденных в направлении корня (при рекурсивных вызовах); используется для определения размера возвращаемого массива - Возвращает:
- массив TreeNode, задающий путь от корня к указанному узлу
addTreeModelListener
public void addTreeModelListener(TreeModelListener l)
- Определено в:
-
addTreeModelListenerв интерфейсеTreeModel - Параметры:
-
l— добавляемый слушатель - См. также:
removeTreeModelListener
public void removeTreeModelListener(TreeModelListener l)
- Определено в:
-
removeTreeModelListenerв интерфейсеTreeModel - Параметры:
-
l— удаляемый слушатель - См. также:
getTreeModelListeners
public TreeModelListener[] getTreeModelListeners()
- Возвращает:
- все
TreeModelListenerэтой модели или пустой массив, если в данный момент не зарегистрировано ни одного слушателя модели дерева - Начиная с версии:
- 1.4
- См. также:
fireTreeNodesChanged
protected void fireTreeNodesChanged(Object source, Object[] path, int[] childIndices, Object[] children)
- Параметры:
-
source— источникTreeModelEvent; обычноthis -
path— путь к родительскому узлу измененных узлов; используйтеnull, чтобы указать, что изменился корневой узел -
childIndices— индексы измененных элементов -
children— измененные элементы
fireTreeNodesInserted
protected void fireTreeNodesInserted(Object source, Object[] path, int[] childIndices, Object[] children)
- Параметры:
-
source— источникTreeModelEvent; обычноthis -
path— путь к родительскому узлу, в который были добавлены узлы -
childIndices— индексы новых элементов -
children— новые элементы
fireTreeNodesRemoved
protected void fireTreeNodesRemoved(Object source, Object[] path, int[] childIndices, Object[] children)
- Параметры:
-
source— источникTreeModelEvent; обычноthis -
path— путь к родительскому узлу, из которого были удалены узлы -
childIndices— индексы удаленных элементов -
children— удаленные элементы
fireTreeStructureChanged
protected void fireTreeStructureChanged(Object source, Object[] path, int[] childIndices, Object[] children)
- Параметры:
-
source— источникTreeModelEvent; обычноthis -
path— путь к родительскому узлу измененной структуры; используйтеnull, чтобы указать, что изменился корневой узел -
childIndices— индексы затронутых элементов -
children— затронутые элементы
getListeners
public <T extends EventListener> T[] getListeners(Class<T> listenerType)
FooListener. Регистрация FooListener выполняется с помощью метода addFooListener. В качестве аргумента listenerType можно указать литерал класса, например FooListener.class. Например, можно запросить у DefaultTreeModel m слушателей модели дерева следующим образом:
TreeModelListener[] tmls = (TreeModelListener[])(m.getListeners(TreeModelListener.class));Если таких слушателей нет, этот метод возвращает пустой массив.
- Параметры типа:
T— тип слушателя- Параметры:
-
listenerType— тип запрашиваемых слушателей - Возвращает:
- массив всех объектов, зарегистрированных в этом компоненте в качестве
FooListener, или пустой массив, если такие слушатели не добавлены - Вызывает исключение:
-
ClassCastException— еслиlistenerTypeне задает класс или интерфейс, реализующийjava.util.EventListener - Начиная с версии:
- 1.3
- См. также:
© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.