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

См. также:

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

Модификатор и тип	Метод	Описание
`boolean`	`dispatchKeyEvent(KeyEvent e)`	Этот метод вызывается текущим KeyboardFocusManager, запрашивая, чтобы этот KeyEventDispatcher обработался указанное событие от его имени.

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

dispatchKeyEvent

boolean dispatchKeyEvent(KeyEvent e)

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

Если реализация этого метода возвращает false, то KeyEvent передается следующему KeyEventDispatcher в цепочке, заканчивая текущим KeyboardFocusManager. Если реализация возвращает true, то предполагается, что KeyEvent был обработан (хотя это необязательно), и текущий KeyboardFocusManager не будет предпринимать дальнейших действий по отношению к KeyEvent. В таком случае, KeyboardFocusManager.dispatchEvent должно возвращать true тоже. Если реализация потребляет KeyEvent, но возвращает false, потреблённое событие всё равно будет передано следующему KeyEventDispatcher в цепочке. Разработчики должны проверять, был ли KeyEvent потреблён перед его отправкой целевому объекту. По умолчанию, текущий KeyboardFocusManager не будет обрабатывать потреблённый KeyEvent.

Параметры:

e - KeyEvent для обработки

Возвращает:

true если KeyboardFocusManager не должен предпринимать дальнейших действий по отношению к KeyEvent; false иначе

См. также:

© 1993, 2023, 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/21/docs/api/java.desktop/java/awt/KeyEventDispatcher.html