Интерфейс KeyEventDispatcher
- Все известные реализующие классы:
- DefaultFocusManager, DefaultKeyboardFocusManager, FocusManager, KeyboardFocusManager
- Функциональный интерфейс:
- Это функциональный интерфейс и, следовательно, может быть использован в качестве цели присваивания лямбда-выражения или ссылки на метод.
@FunctionalInterface public interface KeyEventDispatcher
KeyEventDispatcher взаимодействует с текущим KeyboardFocusManager при обработке и распределении всех KeyEvents. KeyEventDispatchers, зарегистрированные с текущим KeyboardFocusManager, получат KeyEvents до их отправки целевым объектам, что позволит каждому KeyEventDispatcher перенаправить событие, потреблять его, отправить событие самостоятельно или внести другие изменения.
Обратите внимание, что сам KeyboardFocusManager реализует KeyEventDispatcher. По умолчанию, текущий KeyboardFocusManager будет приемником всех KeyEvents, не обработанных зарегистрированными KeyEventDispatchers. Текущий KeyboardFocusManager не может быть полностью дезактивирован как KeyEventDispatcher. Однако, если KeyEventDispatcher сообщает о том, что он обработал KeyEvent, независимо от того, действительно ли он это сделал, KeyboardFocusManager не будет предпринимать дальнейших действий относительно KeyEvent. (Хотя клиентский код может зарегистрировать текущий KeyboardFocusManager как KeyEventDispatcher один или несколько раз, это обычно не требуется и не рекомендуется.)
- С:
- 1.4
- См. также:
-
KeyboardFocusManager.addKeyEventDispatcher(java.awt.KeyEventDispatcher),KeyboardFocusManager.removeKeyEventDispatcher(java.awt.KeyEventDispatcher)
Методы
| Модификатор и тип | Метод и описание |
|---|---|
boolean |
dispatchKeyEvent(KeyEvent e) Этот метод вызывается текущим KeyboardFocusManager, запрашивая, чтобы этот KeyEventDispatcher обработал указанное событие от его имени. |
Методы
dispatchKeyEvent
boolean dispatchKeyEvent(KeyEvent e)
Этот метод вызывается текущим KeyboardFocusManager, запрашивая, чтобы этот KeyEventDispatcher обработал указанное событие от его имени. Этот KeyEventDispatcher может свободно перенаправить событие, потреблять его, обработать его самостоятельно или внести другие изменения. Эта возможность обычно используется для доставки KeyEvents компонентам, отличным от владельца фокуса. Это может быть полезно при навигации по дочерним элементам нефокусируемых окон в доступной среде, например. Обратите внимание, что если KeyEventDispatcher обрабатывает KeyEvent сам, он должен использовать redispatchEvent для предотвращения повторного запроса текущим KeyboardFocusManager обработать событие повторно.
Если реализация этого метода возвращает false, то KeyEvent передается следующему KeyEventDispatcher в цепочке, заканчивающейся текущим KeyboardFocusManager. Если реализация возвращает true, то считается, что KeyEvent был обработан (хотя это может быть не так), и текущий KeyboardFocusManager не будет предпринимать дальнейших действий относительно KeyEvent. В таком случае, KeyboardFocusManager.dispatchEvent также должен вернуть true. Если реализация потребляет KeyEvent, но возвращает false, потребленное событие все равно будет передано следующему KeyEventDispatcher в цепочке. Разработчики должны проверять, был ли KeyEvent потреблен, прежде чем отправлять его целевому объекту. По умолчанию, текущий KeyboardFocusManager не будет обрабатывать потребленный KeyEvent.
- Параметры:
-
e- KeyEvent для обработки - Возвращает:
-
trueесли KeyboardFocusManager не должен предпринимать дальнейших действий относительно KeyEvent;falseв противном случае - См. также:
KeyboardFocusManager.redispatchEvent(java.awt.Component, java.awt.AWTEvent)
© 1993, 2020, 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.
