Класс TreeSelectionEvent

java.lang.Object

java.util.EventObject

javax.swing.event.TreeSelectionEvent

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

public class TreeSelectionEvent extends EventObject

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

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

См. также:

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

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

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

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

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

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

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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/event/TreeSelectionEvent.html