Интерфейс 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);

Parameters:: eventDispatcher - объект EventDispatcher для добавления в цепочку
Returns:: цепочка с добавленным обработчиком событий

prepend

EventDispatchChain prepend(EventDispatcher eventDispatcher)

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

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

Parameters:: eventDispatcher - объект EventDispatcher для вставки в начало цепочки
Returns:: цепочка с добавленным обработчиком событий

dispatchEvent

Event dispatchEvent(Event event)

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

Parameters:: event - событие для обработки
Returns:: обработанное событие или 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.