javax.swing.tree

Класс DefaultTreeModel

java.lang. Объект

javax.swing.tree. DefaultTreeModel

Все Реализованные Интерфейсы:

Сериализуемый, TreeModel

public class DefaultTreeModel
extends Object
implements Serializable, TreeModel

Простая древовидная модель данных, которая использует TreeNodes. Для дополнительной информации и примеров, которые используют DefaultTreeModel, см., Как Использовать Деревья в Учебном руководстве по Java.

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

Полевая Сводка

Поля

Модификатор и Тип	Поле и Описание
protected boolean	asksAllowsChildren Определяет как isLeaf метод выясняет, если узел является вершиной.
protected EventListenerList	listenerList Слушатели.
protected TreeNode	корень Корень дерева.

Сводка конструктора

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

Конструктор и Описание
DefaultTreeModel(TreeNode root) Создает дерево, в котором у любого узла могут быть дочерние элементы.
DefaultTreeModel(TreeNode root, boolean asksAllowsChildren) Создает дерево, определяющее, могут ли у какого-либо узла быть дочерние элементы, или могут ли только у определенных узлов быть дочерние элементы.

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
void	addTreeModelListener(TreeModelListener l) Добавляет слушатель для TreeModelEvent, отправленного после древовидных изменений.
boolean	asksAllowsChildren() Говорит, как определяются вершины.
protected void	fireTreeNodesChanged(Object source, Object[] path, int[] childIndices, Object[] children) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
protected void	fireTreeNodesInserted(Object source, Object[] path, int[] childIndices, Object[] children) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
protected void	fireTreeNodesRemoved(Object source, Object[] path, int[] childIndices, Object[] children) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
protected void	fireTreeStructureChanged(Object source, Object[] path, int[] childIndices, Object[] children) Уведомляет всех слушателей, которые зарегистрировали интерес для уведомления на этом типе события.
Объект	getChild(Object parent, int index) Возвращает дочерний элемент родителя по индексному индексу в дочернем массиве родителя.
int	getChildCount(Object parent) Возвращает число дочерних элементов родителя.
int	getIndexOfChild(Object parent, Object child) Возвращает индекс дочернего элемента в родителе.
<T extends EventListener> T[]	getListeners(Class<T> listenerType) Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на эту модель.
TreeNode[]	getPathToRoot(TreeNode aNode) Создает родителей узла до и включая корневой узел, где исходный узел является последним элементом в возвращенном массиве.
protected TreeNode[]	getPathToRoot(TreeNode aNode, int depth) Создает родителей узла до и включая корневой узел, где исходный узел является последним элементом в возвращенном массиве.
Объект	getRoot() Возвращает корень дерева.
TreeModelListener[]	getTreeModelListeners() Возвращает массив всех древовидных слушателей модели, зарегистрированных на этой модели.
void	insertNodeInto(MutableTreeNode newChild, MutableTreeNode parent, int index) Вызванный это, чтобы вставить newChild в расположении индексирует в родительских дочерних элементах.
boolean	isLeaf(Object node) Возвраты, является ли указанный узел вершиной.
void	nodeChanged(TreeNode node) Вызовите этот метод после того, как Вы изменились, как узел должен быть представлен в дереве.
void	nodesChanged(TreeNode node, int[] childIndices) Вызовите этот метод после того, как Вы изменились, как дочерние элементы, идентифицированные childIndicies, должны быть представлены в дереве.
void	nodeStructureChanged(TreeNode node) Вызовите этот метод, если Вы полностью изменили дочерние элементы узла и его childrens дочерние элементы...
void	nodesWereInserted(TreeNode node, int[] childIndices) Вызовите этот метод после того, как Вы ввели некоторый TreeNodes в узел.
void	nodesWereRemoved(TreeNode node, int[] childIndices, Object[] removedChildren) Вызовите этот метод после того, как Вы удалили некоторый TreeNodes из узла.
void	reload() Вызовите этот метод, если Вы изменили TreeNodes, от которого зависит эта модель.
void	reload(TreeNode node) Вызовите этот метод, если Вы изменили TreeNodes, от которого зависит эта модель.
void	removeNodeFromParent(MutableTreeNode node) Передайте это, чтобы удалить узел из его родителя.
void	removeTreeModelListener(TreeModelListener l) Удаляет слушателя, ранее добавленного с addTreeModelListener ().
void	setAsksAllowsChildren(boolean newValue) Наборы, протестировать ли leafness, спрашивая getAllowsChildren () или isLeaf () к TreeNodes.
void	setRoot(TreeNode root) Устанавливает корень в root.
void	valueForPathChanged(TreePath path, Object newValue) Это устанавливает пользовательский объект TreeNode, идентифицированного путем, и отправляет измененный узел.

Методы java.lang унаследованный от класса. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Полевая Деталь

корень

protected TreeNode root

Корень дерева.

listenerList

protected EventListenerList listenerList

Слушатели.

asksAllowsChildren

protected boolean asksAllowsChildren

Определяет как isLeaf метод выясняет, если узел является вершиной. Если это правда, узел является вершиной, если он не позволяет дочерние элементы. (Если это позволяет дочерние элементы, это не вершина, даже если никакие дочерние элементы не присутствуют.), Который позволяет Вам различать узлы папки и узлы файла в файловой системе, например.

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

См. Также:

TreeNode.getAllowsChildren(), TreeModel.isLeaf(java.lang.Object), setAsksAllowsChildren(boolean)

Деталь конструктора

DefaultTreeModel

@ConstructorProperties(value="root")
public DefaultTreeModel(TreeNode root)

Создает дерево, в котором у любого узла могут быть дочерние элементы.

Параметры:

root - объект TreeNode, который является корнем дерева

См. Также:

DefaultTreeModel(TreeNode, boolean)

DefaultTreeModel

public DefaultTreeModel(TreeNode root,
                boolean asksAllowsChildren)

Создает дерево, определяющее, могут ли у какого-либо узла быть дочерние элементы, или могут ли только у определенных узлов быть дочерние элементы.

Параметры:

root - объект TreeNode, который является корнем дерева

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

См. Также:

asksAllowsChildren

Деталь метода

setAsksAllowsChildren

public void setAsksAllowsChildren(boolean newValue)

Наборы, протестировать ли leafness, спрашивая getAllowsChildren () или isLeaf () к TreeNodes. Если newvalue является истиной, getAllowsChildren () передается, иначе isLeaf () передается.

asksAllowsChildren

public boolean asksAllowsChildren()

Говорит, как определяются вершины.

Возвраты:

истина, если только узлы, которые не позволяют дочерние элементы, являются вершинами, ложь, если узлы, у которых нет никаких дочерних элементов (даже если позволенный) вершины

См. Также:

asksAllowsChildren

setRoot

public void setRoot(TreeNode root)

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

getRoot

public Object getRoot()

Возвращает корень дерева. Нуль возвратов, только если у дерева нет никаких узлов.

Определенный:

getRoot в интерфейсе TreeModel

Возвраты:

корень дерева

getIndexOfChild

public int getIndexOfChild(Object parent,
                  Object child)

Возвращает индекс дочернего элемента в родителе. Если или родитель или дочерний элемент null, возвраты-1.

Определенный:

getIndexOfChild в интерфейсе TreeModel

Параметры:

parent - примечание в дереве, полученном из этого источника данных

child - узел мы интересуемся

Возвраты:

индекс дочернего элемента в родителе, или-1, если или родитель или дочерний элемент null

getChild

public Object getChild(Object parent,
              int index)

Возвращает дочерний элемент родителя по индексному индексу в дочернем массиве родителя. родитель должен быть узлом, ранее полученным из этого источника данных. Это не должно возвратить нуль, если индекс является допустимым индексом для родителя (который является индексом> = 0 && индексный < getChildCount(родитель)).

Определенный:

getChild в интерфейсе TreeModel

Параметры:

parent - узел в дереве, полученном из этого источника данных

Возвраты:

дочерний элемент родителя по индексному индексу

getChildCount

public int getChildCount(Object parent)

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

Определенный:

getChildCount в интерфейсе TreeModel

Параметры:

parent - узел в дереве, полученном из этого источника данных

Возвраты:

число дочерних элементов родителя узла

isLeaf

public boolean isLeaf(Object node)

Возвраты, является ли указанный узел вершиной. Путем тест выполняется, зависит от askAllowsChildren установка.

Определенный:

isLeaf в интерфейсе TreeModel

Параметры:

node - узел, чтобы проверить

Возвраты:

истина, если узел является вершиной

См. Также:

asksAllowsChildren, TreeModel.isLeaf(java.lang.Object)

перезагрузка

public void reload()

Вызовите этот метод, если Вы изменили TreeNodes, от которого зависит эта модель. Модель уведомит всех своих слушателей, что модель изменилась.

valueForPathChanged

public void valueForPathChanged(TreePath path,
                       Object newValue)

Это устанавливает пользовательский объект TreeNode, идентифицированного путем, и отправляет измененный узел. Если Вы используете пользовательские пользовательские объекты в TreeModel, Вы собираетесь должны разделить это на подклассы и установить пользовательский объект измененного узла к чему-то значимому.

Определенный:

valueForPathChanged в интерфейсе TreeModel

Параметры:

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

newValue - новое значение от TreeCellEditor

insertNodeInto

public void insertNodeInto(MutableTreeNode newChild,
                  MutableTreeNode parent,
                  int index)

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

removeNodeFromParent

public void removeNodeFromParent(MutableTreeNode node)

Передайте это, чтобы удалить узел из его родителя. Это передаст nodesWereRemoved, чтобы создать соответствующее событие. Это - привилегированный способ удалить узел, поскольку он обрабатывает создание события для Вас.

nodeChanged

public void nodeChanged(TreeNode node)

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

перезагрузка

public void reload(TreeNode node)

Вызовите этот метод, если Вы изменили TreeNodes, от которого зависит эта модель. Модель уведомит всех своих слушателей, что модель изменилась ниже данного узла.

Параметры:

node - узел, ниже которого изменилась модель

nodesWereInserted

public void nodesWereInserted(TreeNode node,
                     int[] childIndices)

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

nodesWereRemoved

public void nodesWereRemoved(TreeNode node,
                    int[] childIndices,
                    Object[] removedChildren)

Вызовите этот метод после того, как Вы удалили некоторый TreeNodes из узла. childIndices должен быть индексом удаленных элементов и должен быть сортирован в порядке возрастания. И removedChildren должен быть массивом объектов дочерних элементов, которые были удалены.

nodesChanged

public void nodesChanged(TreeNode node,
                int[] childIndices)

Вызовите этот метод после того, как Вы изменились, как дочерние элементы, идентифицированные childIndicies, должны быть представлены в дереве.

nodeStructureChanged

public void nodeStructureChanged(TreeNode node)

Вызовите этот метод, если Вы полностью изменили дочерние элементы узла и его childrens дочерние элементы... Это отправит treeStructureChanged событие.

getPathToRoot

public TreeNode[] getPathToRoot(TreeNode aNode)

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

Параметры:

aNode - TreeNode, чтобы получить путь для

getPathToRoot

protected TreeNode[] getPathToRoot(TreeNode aNode,
                       int depth)

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

Параметры:

aNode - TreeNode, чтобы получить путь для

depth - интервал, дающий число шагов, уже сделанных к корню (на рекурсивных вызовах), используемый, чтобы измерить возвращенный массив

Возвраты:

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

addTreeModelListener

public void addTreeModelListener(TreeModelListener l)

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

Определенный:

addTreeModelListener в интерфейсе TreeModel

Параметры:

l - слушатель, чтобы добавить

См. Также:

removeTreeModelListener(javax.swing.event.TreeModelListener)

removeTreeModelListener

public void removeTreeModelListener(TreeModelListener l)

Удаляет слушателя, ранее добавленного с addTreeModelListener ().

Определенный:

removeTreeModelListener в интерфейсе TreeModel

Параметры:

l - слушатель, чтобы удалить

См. Также:

addTreeModelListener(javax.swing.event.TreeModelListener)

getTreeModelListeners

public TreeModelListener[] getTreeModelListeners()

Возвращает массив всех древовидных слушателей модели, зарегистрированных на этой модели.

Возвраты:

вся эта модель TreeModelListeners или пустой массив, если никакие древовидные слушатели модели в настоящий момент не регистрируются

С тех пор:

1.4

См. Также:

addTreeModelListener(javax.swing.event.TreeModelListener), removeTreeModelListener(javax.swing.event.TreeModelListener)

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)

Возвращает массив всех объектов, в настоящий момент зарегистрированных как FooListeners на эту модель. FooListeners регистрируются, используя addFooListener метод.

Можно определить listenerType параметр с литералом класса, такой как FooListener.class. Например, можно запросить a DefaultTreeModel m для его древовидных слушателей модели со следующим кодом:

TreeModelListener[] tmls = (TreeModelListener[])(m.getListeners(TreeModelListener.class));

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

Параметры:

listenerType - тип слушателей требуют; этот параметр должен определить интерфейс, который убывает от java.util.EventListener

Возвраты:

массив всех объектов, зарегистрированных как FooListeners на этом компоненте, или пустом массиве, если никакие такие слушатели не были добавлены

Броски:

ClassCastException - если listenerType не определяет класс или интерфейс, который реализует java.util.EventListener

С тех пор:

1.3

См. Также:

getTreeModelListeners()