Интерфейс EventDispatchChain

public interface EventDispatchChain

Представляет цепочку объектов EventDispatcher, которые могут рассылать событие Event. Событие распределяется путём его передачи от одного объекта EventDispatcher к следующему в цепочке до достижения её конца. Каждый объект EventDispatcher в цепочке может влиять на путь события и само событие. Цепочка обычно формируется путём следования иерархии родитель-потомок от корня до целевого объекта события и добавления всех объектов EventDispatcher, встреченных на пути, в цепочку.

Since:: JavaFX 2.0

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

Модификатор и тип	Метод	Описание
`EventDispatchChain`	`append(EventDispatcher eventDispatcher)`	Добавляет указанный объект `EventDispatcher` в эту цепочку.
`Event`	`dispatchEvent(Event event)`	Распространяет указанное событие через эту цепочку `EventDispatchChain`.
`EventDispatchChain`	`prepend(EventDispatcher eventDispatcher)`	Вставляет указанный объект `EventDispatcher` в начало этой цепочки.

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

append

EventDispatchChain append(EventDispatcher eventDispatcher)

Добавляет указанный объект EventDispatcher в эту цепочку. Возвращает ссылку на цепочку с добавленным элементом.

Вызывающий метод не должен предполагать, что эта цепочка EventDispatchChain останется неизменной, или что возвращаемое значение будет ссылаться на другую цепочку после вызова. Всё это зависит от реализации EventDispatchChain.

Поэтому вызов всегда должен выполняться в следующей форме: chain = chain.append(eventDispatcher);

Параметры:: eventDispatcher - объект EventDispatcher, который нужно добавить в цепочку
Возвращает:: цепочку с добавленным обработчиком событий

prepend

EventDispatchChain prepend(EventDispatcher eventDispatcher)

Вставляет указанный объект EventDispatcher в начало этой цепочки. Возвращает ссылку на цепочку с добавленным элементом.

Поэтому вызов всегда должен выполняться в следующей форме: chain = chain.prepend(eventDispatcher);

Параметры:: eventDispatcher - объект EventDispatcher, который нужно вставить в начало цепочки
Возвращает:: цепочку с добавленным обработчиком событий в начало

dispatchEvent

Event dispatchEvent(Event event)

Распространяет указанное событие через эту цепочку EventDispatchChain. Возвращаемое значение представляет событие после обработки, выполненной цепочкой. Если дальнейшая обработка должна быть выполнена после вызова, то необходимо использовать событие, на которое ссылается возвращаемое значение, а не исходное событие. В случае, если событие полностью обработано/поглощено в цепочке, возвращаемое значение равно null и дальнейшая обработка этого события не должна выполняться.

Параметры:: event - событие для распространения
Возвращает:: обработанное событие или null, если событие было полностью обработано/поглощено

© 2008, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from JavaFX API Documentation.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Java, JavaFX and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.