javax.swing.tree

Интерфейс TreeModel

Все Известные Классы с реализацией:

DefaultTreeModel

public interface TreeModel

Модель, используемая JTree.

JTree и его связанные классы делают широкое применение TreePaths для indentifying узлов в TreeModel. Если a TreeModel возвращает тот же самый объект, как сравнено equals, в двух различных индексах под тем же самым родителем чем получающееся TreePath объекты будут считать равными также. Некоторые реализации могут принять это если два TreePaths равны, они идентифицируют тот же самый узел. Если это условие не соблюдают, крася проблемы, и другие причуды могут закончиться. Другими словами, если getChild поскольку данный родитель возвращает тот же самый Объект (как определено equals) проблемы могут закончиться, и рекомендуется, чтобы Вы избежали делать это.

Так же JTree и его связанное место классов TreePaths в Maps. Как таковой, если узел требуют дважды, возвращаемые значения должны быть равными (использование equals метод), и имеют то же самое hashCode.

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

См. Также:

TreePath

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

Модификатор и Тип	Метод и Описание
void	addTreeModelListener(TreeModelListener l) Добавляет слушатель для TreeModelEvent отправленный после древовидных изменений.
Объект	getChild(Object parent, int index) Возвращает дочерний элемент parent в индексируют index в дочернем массиве родителя.
int	getChildCount(Object parent) Возвращает число дочерних элементов parent.
int	getIndexOfChild(Object parent, Object child) Возвращает индексирование дочернего элемента в родителе.
Объект	getRoot() Возвращает корень дерева.
boolean	isLeaf(Object node) Возвраты true если node лист.
void	removeTreeModelListener(TreeModelListener l) Удаляет слушателя, ранее добавленного с addTreeModelListener.
void	valueForPathChanged(TreePath path, Object newValue) Переданный, когда пользователь изменил значение для элемента, идентифицированного path к newValue.

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

getRoot

Object getRoot()

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

Возвраты:

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

getChild

Object getChild(Object parent,
                int index)

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

Parameters:

parent - a node in the tree, obtained from this data source

Returns:

the child of parent at index index

getChildCount

int getChildCount(Object parent)

Returns the number of children of parent. Returns 0 if the node is a leaf or if it has no children. parent must be a node previously obtained from this data source.

Parameters:

parent - a node in the tree, obtained from this data source

Returns:

the number of children of the node parent

isLeaf

boolean isLeaf(Object node)

Returns true if node is a leaf. It is possible for this method to return false even if node has no children. A directory in a filesystem, for example, may contain no files; the node representing the directory is not a leaf, but it also has no children.

Parameters:

node - a node in the tree, obtained from this data source

Returns:

true if node is a leaf

valueForPathChanged

void valueForPathChanged(TreePath path,
                         Object newValue)

Messaged when the user has altered the value for the item identified by path to newValue. If newValue signifies a truly new value the model should post a treeNodesChanged event.

Parameters:

path - path to the node that the user has altered

newValue - the new value from the TreeCellEditor

getIndexOfChild

int getIndexOfChild(Object parent,
                    Object child)

Returns the index of child in parent. If either parent or child is null, returns -1. If either parent or child don't belong to this tree model, returns -1.

Parameters:

parent - a node in the tree, obtained from this data source

child - the node we are interested in

Returns:

the index of the child in the parent, or -1 if either child or parent are null or don't belong to this tree model

addTreeModelListener

void addTreeModelListener(TreeModelListener l)

Adds a listener for the TreeModelEvent posted after the tree changes.

Parameters:

l - the listener to add

See Also:

removeTreeModelListener(javax.swing.event.TreeModelListener)

removeTreeModelListener

void removeTreeModelListener(TreeModelListener l)

Removes a listener previously added with addTreeModelListener.

Parameters:

l - the listener to remove

See Also:

addTreeModelListener(javax.swing.event.TreeModelListener)