javax.swing.event

Класс TreeModelEvent

java.lang. Объект

java.util. EventObject

javax.swing.event. TreeModelEvent

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

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

public class TreeModelEvent
extends EventObject

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

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

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

Поля

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

Поля 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() Возвращает строку, которая выводит на экран и идентифицирует свойства этого объекта.

Методы java.util унаследованный от класса. EventObject

getSource

Методы 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 класс, 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 в классе EventObject

Возвраты:

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