Spec-Zone.ru › OpenJDK 17

Интерфейс 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 с запросом об обработке указанного события KeyEvent от его имени.

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

dispatchKeyEvent

boolean dispatchKeyEvent(KeyEvent e)
Этот метод вызывается текущим KeyboardFocusManager с запросом об обработке указанного события KeyEvent от его имени. Этот KeyEventDispatcher может переназначить событие, потреблять его, обработать его самостоятельно или внести другие изменения. Эта возможность обычно используется для передачи KeyEvents компонентам, отличным от владельца фокуса. Это может быть полезно при навигации по дочерним элементам нефокусируемых окон в доступной среде, например. Обратите внимание, что если KeyEventDispatcher обрабатывает KeyEvent самостоятельно, он должен использовать redispatchEvent для предотвращения повторного запроса текущего KeyboardFocusManager об обработке события KeyEvent.

Если реализация этого метода возвращает 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, 2021, 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.
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/java/awt/KeyEventDispatcher.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API