Класс TreeSelectionEvent

java.lang.Object

java.util.EventObject

javax.swing.event.TreeSelectionEvent

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

public class TreeSelectionEvent extends EventObject

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

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками 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`	Пути, представленные этим событием.

Поля, объявленные в классе java.util.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)`	Возвращает, был ли указанный путь добавлен к выбору.

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

getSource, toString

Методы, объявленные в классе java.lang.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 - массив, указывающий, являются ли пути в 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 - источник события
Возвращает:: объект Object, который является копией этого события с источником, предоставленным в качестве параметра

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/event/TreeSelectionEvent.html