javax.swing.event

Класс TreeModelEvent

java.lang. Объект

java.util. EventObject

javax.swing.event. TreeModelEvent

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

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

public class TreeModelEvent
extends EventObject

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

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

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

Поля

Модификатор и Тип	Поле и Описание
protected int[]	childIndices Индексы, идентифицирующие позицию того, где дочерние элементы были.
protected Object[]	дочерние элементы Дочерние элементы, которые были удалены.
protected TreePath	путь Путь к родителю узлов, которые изменились.

Поля, наследованные от class java.util. EventObject

источник

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

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

Конструктор и Описание
TreeModelEvent(Object source, Object[] path) Используемый, чтобы создать событие, когда структура узла изменилась в некотором роде, идентифицируя путь к корню измененного поддерева как массив Объектов.
TreeModelEvent(Object source, Object[] path, int[] childIndices, Object[] children) Используемый, чтобы создать событие, когда узлы были изменены, вставленные, или удаленные, идентифицируя путь к родителю измененных элементов как массив Объектов.
TreeModelEvent(Object source, TreePath path) Используемый, чтобы создать событие, когда структура узла изменилась в некотором роде, идентифицируя путь к корню измененного поддерева, поскольку TreePath возражает.
TreeModelEvent(Object source, TreePath path, int[] childIndices, Object[] children) Используемый, чтобы создать событие, когда узлы были изменены, вставленные, или удаленные, идентифицируя путь к родителю измененных элементов, поскольку TreePath возражают.

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

Модификатор и Тип	Метод и Описание
int[]	getChildIndices() Возвращается значения дочернего элемента индексирует.
Объект[]	getChildren() Возвращает объекты, которые являются дочерними элементами узла, идентифицированного getPath в расположениях, определенных getChildIndices.
Объект[]	getPath() Метод удобства, чтобы получить массив объектов от экземпляра TreePath, который обертывает это событие.
TreePath	getTreePath() Для всех событий, кроме treeStructureChanged, возвращает родителя измененных узлов.
Строка	toString() Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.

Методы, наследованные от class java.util. EventObject

getSource

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

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

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

путь

protected TreePath path

Путь к родителю узлов, которые изменились.

childIndices

protected int[] childIndices

Индексы, идентифицирующие позицию того, где дочерние элементы были.

дочерние элементы

protected Object[] children

Дочерние элементы, которые были удалены.

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

TreeModelEvent

public TreeModelEvent(Object source,
                      Object[] path,
                      int[] childIndices,
                      Object[] children)

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

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

Для вставок индексирование представляет конечное состояние дерева, после того, как вставки произошли. Так как индексирование должно быть определено в порядке, самая естественная методология обработки должна сделать, вставки, запускающиеся в самом низком, индексируют и работа для самого высокого. Накопите Вектор Integer объекты, которые определяют вставлять-расположения, как Вы идете, затем преобразуйте Вектор в массив int создать событие. Когда postition-индексирование равняется нулю, узел вставляется в начале списка. То, когда позиция индексирует, равняется размеру списка, узел "вставляется" в (добавленный к) конец списка.

Для удаляет, индексирование представляют начальное состояние дерева, прежде, чем удаление произошло. Так как индексирование должно быть определено в порядке, самая естественная методология обработки должна использовать удалять-счетчик. Запустите, инициализируя в противоречии с нулем и запустите работу через список от самого низкого до higest. Каждый раз Вы делаете удаление, добавляете текущую стоимость удаления - в противоречии с индексированием позиционного, где удаление произошло, и добавьте результат к Вектору удалять-расположений, используя addElement(). Затем постепенно увеличьте удалять-счетчик. Индексировать позиции, сохраненные в Векторе поэтому, отражают, что эффекты всех предыдущих удаляют, таким образом, они представляют позицию каждого объекта в начальном дереве. (Вы могли также запустить в самом высоком, индексируют и работающий назад к самому низкому, накапливая Вектор удалять-расположений, поскольку Вы идете, используя insertElementAt(Integer, 0).) Однако Вы производите Вектор начальных позиций, Вы тогда должны преобразовать Вектор Integer объекты массиву int создать событие.

Примечания:

• Как insertNodeInto метод в DefaultTreeModel class, insertElementAt добавляет к Vector когда индексировать соответствия размер вектора. Таким образом, можно использовать insertElementAt(Integer, 0) даже когда вектор пуст.
  Чтобы создать узел измененное событие для корневого узла, определите родителя и дочерние индексы как null.

Параметры:

source - Объект, ответственный за генерирование события (обычно создатель передач объекта-события this для его значения)

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

childIndices - массив int это определяет индексировать значения удаленных элементов. Индексы должны быть в сортированном порядке от самого низкого до самого высокого

children - массив Объекта, содержащего вставленные, удаленные, или измененные объекты

См. Также:

TreePath

TreeModelEvent

public TreeModelEvent(Object source,
                      TreePath path,
                      int[] childIndices,
                      Object[] children)

Используемый, чтобы создать событие, когда узлы были изменены, вставленные, или удаленные, идентифицируя путь к родителю измененных элементов, поскольку TreePath возражают. Для получения дополнительной информации по тому, как определить индексирование и объекты, см. TreeModelEvent(Object,Object[],int[],Object[]).

Параметры:

source - Объект, ответственный за генерирование события (обычно создатель передач объекта-события this для его значения)

path - объект TreePath, который идентифицирует путь к родителю измененного элемента (ов)

childIndices - массив int это определяет индексировать значения измененных элементов

children - массив Объекта, содержащего вставленные, удаленные, или измененные объекты

См. Также:

TreeModelEvent(Object,Object[],int[],Object[])

TreeModelEvent

public TreeModelEvent(Object source,
                      Object[] path)

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

Отметьте:
JTree сворачивает все узлы под указанным узлом, так, чтобы только его непосредственные дочерние элементы были видимы.

Параметры:

source - Объект, ответственный за генерирование события (обычно создатель передач объекта-события this для его значения)

path - массив Объекта, идентифицирующего путь к корню измененного поддерева, где первый элемент массива является объектом, хранившим в корневом узле и последнем элементе, является объектом, хранившим в измененном узле

См. Также:

TreePath

TreeModelEvent

public TreeModelEvent(Object source,
                      TreePath path)

Используемый, чтобы создать событие, когда структура узла изменилась в некотором роде, идентифицируя путь к корню измененного поддерева, поскольку TreePath возражает. Для получения дополнительной информации по этой спецификации события см. TreeModelEvent(Object,Object[]).

Параметры:

source - Объект, ответственный за генерирование события (обычно создатель передач объекта-события this для его значения)

path - объект TreePath, который идентифицирует путь к изменению. В DefaultTreeModel этот объект содержит массив пользовательских объектов данных, но подкласс TreePath мог использовать некоторый полностью различный механизм - например, Идентификационный номер узла

См. Также:

TreeModelEvent(Object,Object[])

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

getTreePath

public TreePath getTreePath()

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

Одно исключение к этому является treeNodesChanged событием, которое должно идентифицировать корень, когда это возвратит корень и getChildIndices возвратит нуль.

Возвраты:

TreePath, используемый в идентификации измененных узлов.

См. Также:

TreePath.getLastPathComponent()

getPath

public Object[] getPath()

Метод удобства, чтобы получить массив объектов от экземпляра TreePath, который обертывает это событие.

Возвраты:

массив Объектов, где первый Объект является тем, сохраненным в корне и последнем объекте, является тем, сохраненным в узле, идентифицированном путем

getChildren

public Object[] getChildren()

Возвращает объекты, которые являются дочерними элементами узла, идентифицированного getPath в расположениях, определенных getChildIndices. Если это - событие удаления, возвращенные объекты больше не являются дочерними элементами родительского узла.

Возвраты:

массив Объекта, содержащего дочерние элементы, определяется событием

См. Также:

getPath(), getChildIndices()

getChildIndices

public int[] getChildIndices()

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

Возвраты:

массив int содержа индексирует расположения для дочерних элементов, определенных событием

toString

public String toString()

Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.

Переопределения:

toString в class EventObject

Возвраты:

Строковое представление этого объекта