Класс TreeSelectionEvent

java.lang.Object

java.util.EventObject

javax.swing.event.TreeSelectionEvent

Все реализуемые интерфейсы:: Serializable

public class TreeSelectionEvent extends EventObject

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

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

См. также:

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected boolean[]`	`areNew`	Для каждого пути указывает, является ли он новым.
`protected TreePath`	`newLeadSelectionPath`	leadSelectionPath после изменения путей; может иметь значение null.
`protected TreePath`	`oldLeadSelectionPath`	leadSelectionPath до изменения путей; может иметь значение null.
`protected TreePath[]`	`paths`	Пути, представленные этим событием.

Поля, объявленные в классе EventObject

source

Модификатор и тип	Поле	Описание
`protected Object`	`source`	Объект, в котором первоначально произошло событие.

Краткое описание конструкторов

Конструктор	Описание
`TreeSelectionEvent(Object source, TreePath[] paths, boolean[] areNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)`	Представляет изменение выделения в `TreeSelectionModel`.
`TreeSelectionEvent(Object source, TreePath path, boolean isNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)`	Представляет изменение выделения в `TreeSelectionModel`.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`cloneWithSource(Object newSource)`	Возвращает копию этого объекта, в которой в качестве источника используется newSource.
`TreePath`	`getNewLeadSelectionPath()`	Возвращает текущий ведущий путь.
`TreePath`	`getOldLeadSelectionPath()`	Возвращает путь, который ранее был ведущим.
`TreePath`	`getPath()`	Возвращает первый элемент пути.
`TreePath[]`	`getPaths()`	Возвращает пути, добавленные в выделение или удалённые из него.
`boolean`	`isAddedPath()`	Возвращает значение, указывающее, был ли путь, определяемый `getPath`, добавлен в выделение.
`boolean`	`isAddedPath(int index)`	Возвращает значение, указывающее, был ли путь с индексом `getPaths()[index]` добавлен в выделение.
`boolean`	`isAddedPath(TreePath path)`	Возвращает значение, указывающее, был ли указанный путь добавлен в выделение.

Методы, объявленные в классе EventObject

getSource, toString

Модификатор и тип	Метод	Описание
`Object`	`getSource()`	Объект, в котором первоначально произошло событие.
`String`	`toString()`	Возвращает строковое представление этого EventObject.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создаёт и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API может быть удалён в будущей версии. Финализация устарела и будет удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно в результате вызова notify или interrupt, либо истечения заданного промежутка реального времени.

Подробное описание полей

paths

protected TreePath[] paths

Пути, представленные этим событием.

areNew

protected boolean[] areNew

Для каждого пути указывает, является ли он новым.

oldLeadSelectionPath

protected TreePath oldLeadSelectionPath

leadSelectionPath до изменения путей; может иметь значение null.

newLeadSelectionPath

protected TreePath newLeadSelectionPath

leadSelectionPath после изменения путей; может иметь значение null.

Подробное описание конструкторов

TreeSelectionEvent

public TreeSelectionEvent(Object source, TreePath[] paths, boolean[] areNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)

Представляет изменение выделения в TreeSelectionModel. paths определяет пути, добавленные в выделение или удалённые из него.

Параметры:: source — источник события; paths — пути, изменившиеся в выделении; areNew — массив boolean, указывающий, являются ли пути в paths новыми для выделения; oldLeadSelectionPath — предыдущий ведущий путь выделения; newLeadSelectionPath — новый ведущий путь выделения

TreeSelectionEvent

public TreeSelectionEvent(Object source, TreePath path, boolean isNew, TreePath oldLeadSelectionPath, TreePath newLeadSelectionPath)

Представляет изменение выделения в TreeSelectionModel. path определяет путь, добавленный в выделение или удалённый из него.

Параметры:: source — источник события; path — путь, изменившийся в выделении; isNew — является ли путь новым для выделения; значение false означает, что путь был удалён из выделения; oldLeadSelectionPath — предыдущий ведущий путь выделения; newLeadSelectionPath — новый ведущий путь выделения

Подробное описание методов

getPaths

public TreePath[] getPaths()

Возвращает пути, добавленные в выделение или удалённые из него.

Возвращает:: копию массива объектов TreePath для этого события.

getPath

public TreePath getPath()

Возвращает первый элемент пути.

Возвращает:: первый элемент TreePath, представленный этим событием

isAddedPath

public boolean isAddedPath()

Возвращает значение, указывающее, был ли путь, определяемый getPath, добавлен в выделение. Возвращаемое значение true указывает, что путь, определяемый getPath, был добавлен в выделение. Возвращаемое значение false указывает, что


getPath

был выбран, но больше не выбран.

Возвращает:: true, если getPath был добавлен в выделение, иначе false

isAddedPath

public boolean isAddedPath(TreePath path)

Возвращает значение, указывающее, был ли указанный путь добавлен в выделение. Возвращаемое значение true указывает, что путь, определяемый path, был добавлен в выделение. Возвращаемое значение false указывает, что path больше не выбран. Этот метод допустимо использовать только для путей, возвращаемых методом getPaths(); вызов для пути, не входящего в getPaths(), приводит к выбрасыванию IllegalArgumentException.

Параметры:

path — проверяемый путь

Возвращает:

true, если path был добавлен в выделение, иначе false

Выбрасывает:

IllegalArgumentException — если path не содержится в getPaths

См. также:

isAddedPath

public boolean isAddedPath(int index)

Возвращает значение, указывающее, был ли путь с индексом getPaths()[index] добавлен в выделение. Возвращаемое значение true указывает, что путь был добавлен в выделение. Возвращаемое значение false указывает, что путь больше не выбран.

Параметры:

index — индекс проверяемого пути

Возвращает:

true, если путь был добавлен в выделение, иначе false

Выбрасывает:

IllegalArgumentException — если индекс выходит за пределы диапазона getPaths

Начиная с версии:

1.3

См. также:

getOldLeadSelectionPath

public TreePath getOldLeadSelectionPath()

Возвращает путь, который ранее был ведущим.

Возвращает:: объект TreePath, содержащий прежний ведущий путь выделения

getNewLeadSelectionPath

public TreePath getNewLeadSelectionPath()

Возвращает текущий ведущий путь.

Возвращает:: объект TreePath, содержащий новый ведущий путь выделения

cloneWithSource

public Object cloneWithSource(Object newSource)

Возвращает копию этого объекта, в которой в качестве источника используется newSource.

Параметры:: newSource — источник события
Возвращает:: объект Object, являющийся копией этого события с указанным источником newSource

© 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.