|
Register to intercept keyboard events, and either pass them on or consume them.
- Parameters:
-
| listener,: | a DeviceEventListener which will intercept key events. |
| keys,: | a KeySet indicating which keys to intercept, or KEYSET_ALL_KEYS. |
| mask,: | a ControllerEventMask filtering the intercepted key events. |
| type,: | a KeyEventTypeSeq that may created by ORing event types together. |
| mode,: | an EventListenerMode indicating whether the listener should receive the events synchronously, potentially consuming them, or just be notified asynchronously of those events that have been generated. |
- Note:
- Some platforms have limited support for global, preemptive EventListenerMode. Such a registration may fail if another client already has priority for preemptive access to one or more of the members of the KeySet. AT consumers have the option of re-trying the request without the global flag, or without the preemptive flag, or of re-trying with a different KeySet. The best support for pre-emptive global keyboard listeners is provided on platforms whose Xserver implementation provides the XEvIE extension.
- Returns:
True if the DeviceEventListener was successfully registered for the requested KeySet, ControllerEventMask, event types, and EventListenerMode; otherwise returns False .
|