XKB FUNCTIONS XkbGetSlowKeysDelay(3x11)
NAME
XkbGetSlowKeysDelay - Gets the SlowKeys acceptance delay for
a keyboard deviceSYNOPSIS
cc [ flag... ] file... -lX11 [ library... ]
Bool XkbGetSlowKeysDelay (Display *display, unsigned int
device_spec, unsigned int *delay_rtrn);
ARGUMENTS- display
connection to X server- device_spec
device ID, or XkbUseCoreKbd- delay_rtrn
backfilled with SlowKeys delay, msDESCRIPTION
Some users may accidentally bump keys while moving a hand or typing stick toward the key they want. Usually, the keys that are accidentally bumped are just hit for a very short period of time. The SlowKeys control helps filter these accidental bumps by telling the server to wait a specified period, called the SlowKeys acceptance delay, before delivering key events. If the key is released before this period elapses, no key events are generated. Users can then bump any number of keys on their way to the one they want without accidentally getting those characters. Once they have reached the key they want, they can then hold thedesired key long enough for the computer to accept it. Slow-
Keys is a boolean control with one configurable attribute. When the SlowKeys control is active, the server reports the initial key press, subsequent acceptance or rejection, and release of any key to interested clients by sending an appropriate AccessXNotify event (see section 10.6.4). The server can generate XkbAccessXNotify events for some of the global keyboard controls. The detail field describes what AccessX event just occurred and can be any of the values in Table 1. The server can generate XkbAccessXNotify events for some of the global keyboard controls. The detail field describes what AccessX event just occurred and can be any of the values in Table 1. Table 1 AccessXNotify Events____________________________________________________________
detail Reason____________________________________________________________
X Version 11 Last change: libX11 1.3.5 1XKB FUNCTIONS XkbGetSlowKeysDelay(3x11)
XkbAXN_SKPress A key was pressed when SlowKeys was
enabled.XkbAXN_SKAccept A key was accepted (held longer than the
SlowKeys delay).XkbAXN_SKRelease An accepted SlowKeys key was released.
XkbAXN_SKReject A key was rejected (released before the
SlowKeys delay expired).XkbAXN_BKAccept A key was accepted by BounceKeys.
XkbAXN_BKReject A key was rejected (pressed before the
BounceKeys delay expired).XkbAXN_AXKWarning AccessXKeys is about to turn on/off
StickyKeys or BounceKeys. The keycode field reports the keycode of the key for which the event occurred. If the action is related to SlowKeys,the slowKeysDelay field contains the current SlowKeys accep-
tance delay. If the action is related to BounceKeys, the debounceDelay field contains the current BounceKeys debounce delay. Selecting for AccessX EventsTo receive XkbAccessXNotify events under all possible condi-
tions, use XkbSelectEvents and pass XkbAccesXNotifyMask inboth bits_to_change and values_for_bits.
To receive XkbStateNotify events only under certain condi-
tions, use XkbSelectEventDetails using XkbAccessXNotify asthe event_type and specifying the desired state changes in
bits_to_change and values_for_bits using mask bits from
Table 2. Table 2 AccessXNotify Event Details________________________________________________________________________
XkbAccessXNotify Event Details Value Circumstances________________________________________________________________________
XkbAXN_SKPressMask (1<<0) Slow key press notification
wantedXkbAXN_SKAcceptMask (1<<1) Slow key accept notification
wantedXkbAXN_SKRejectMask (1<<2) Slow key reject notification
wantedXkbAXN_SKReleaseMask (1<<3) Slow key release notification
wantedXkbAXN_BKAcceptMask (1<<4) Bounce key accept notification
wantedXkbAXN_BKRejectMask (1<<5) Bounce key reject notification
wantedXkbAXN_AXKWarningMask (1<<6) AccessX warning notification
wanted X Version 11 Last change: libX11 1.3.5 2XKB FUNCTIONS XkbGetSlowKeysDelay(3x11)
XkbAllAccessXEventsMask (0x7f) All AccessX features notifica-
tions wantedXkbGetSlowKeysDelay requests the attributes of the SlowKeys
control from the server, waits for a reply and backfillsdelay_rtrn with the SlowKeys delay attribute. XkbGetSlowK-
eysDelay returns True if successful; , XkbGetSlowKeysDelay
returns False.RETURN VALUES
True The XkbGetSlowKeysDelay function returns True
if the request of the Slowkeys control from the server was successful.False The XkbGetSlowKeysDelay function returns
False if a compatible version of the Xkb extension is not available in the server. STRUCTURESThe structure for the XkbAccessXNotify event type is as fol-
lows: typedef struct { int type; /* Xkb extension base event code */ unsigned long serial; /* X server serial number for event */Bool send_event; /* True => synthetically generated */
Display * display; /* server connection where event generated */ Time time; /* server time when event generated */int xkb_type; /* XkbAccessXNotify */
int device; /* Xkb device ID, will not be XkbUseCoreKbd */int detail; /* XkbAXN_* */
KeyCode keycode; /* key of event */ int slowKeysDelay; /* current SlowKeys delay */ int debounceDelay; /* current debounce delay */ } XkbAccessXNotifyEvent;ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes: X Version 11 Last change: libX11 1.3.5 3XKB FUNCTIONS XkbGetSlowKeysDelay(3x11)
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/library/libx11 ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | See XInitThreads(3X11) |
|_____________________________|_____________________________|
X Version 11 Last change: libX11 1.3.5 4