Интерфейс EventDispatchChain
public interface EventDispatchChain
EventDispatcher, которые могут передавать событие Event. Событие передаётся от одного объекта EventDispatcher к другому в цепочке до её конца. Каждый объект EventDispatcher в цепочке может влиять на путь события и само событие. Цепочка обычно формируется путём следования иерархии родитель-потомок от корня к целевому объекту события и добавлением всех встреченных объектов EventDispatcher в цепочку.- Since:
- JavaFX 2.0
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
EventDispatchChain |
append |
Добавляет указанный объект EventDispatcher в эту цепочку. |
Event |
dispatchEvent |
Передаёт указанное событие через эту цепочку EventDispatchChain. |
EventDispatchChain |
prepend |
Добавляет указанный объект EventDispatcher в начало этой цепочки. |
Подробное описание методов
append
EventDispatchChain append(EventDispatcher eventDispatcher)
EventDispatcher в эту цепочку. Возвращает ссылку на цепочку с добавленным элементом. Вызывающий код не должен предполагать, что эта цепочка EventDispatchChain останется неизменной или что возвращаемое значение будет ссылаться на другую цепочку после вызова. Всё это зависит от реализации EventDispatchChain.
Поэтому вызов всегда должен выполняться в следующем формате: chain = chain.append(eventDispatcher);
- Параметры:
-
eventDispatcher- объектEventDispatcher, который нужно добавить в цепочку - Возвращает:
- цепочку с добавленным обработчиком событий
prepend
EventDispatchChain prepend(EventDispatcher eventDispatcher)
EventDispatcher в начало этой цепочки. Возвращает ссылку на цепочку с добавленным элементом. Вызывающий код не должен предполагать, что эта цепочка EventDispatchChain останется неизменной или что возвращаемое значение будет ссылаться на другую цепочку после вызова. Всё это зависит от реализации EventDispatchChain.
Поэтому вызов всегда должен выполняться в следующем формате: 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.
