Класс TreeSelectionEvent

public class TreeSelectionEvent
extends EventObject

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

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

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

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 - пути, которые изменились в выборе

TreeSelectionEvent

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

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

Параметры:

source - источник события

path - путь, который изменился в выборе

isNew - является ли путь новым в выборе, false означает, что путь был удалён из выбора.

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

getPaths

public TreePath[] getPaths()

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

getPath

public TreePath getPath()

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

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

См. также:

getPaths()

isAddedPath

public boolean isAddedPath(int index)

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

Параметры:

index - индекс пути для проверки

Возвращает:

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

Исключения:

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

С тех пор:

1.3

См. также:

getPaths()

getOldLeadSelectionPath

public TreePath getOldLeadSelectionPath()

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

getNewLeadSelectionPath

public TreePath getNewLeadSelectionPath()

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

cloneWithSource

public Object cloneWithSource(Object newSource)

Возвращает копию получателя, но с источником newSource.