Register to intercept keyboard events, and either pass them on or consume them.
|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. |
- 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.
True if the DeviceEventListener was successfully registered for the requested KeySet, ControllerEventMask, event types, and EventListenerMode; otherwise returns