|
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 . |