Manual Pages for UNIX Operating System command usage for man XkbSetBounceKeysDelay

XKB FUNCTIONS                         XkbSetBounceKeysDelay(3x11)



NAME
     XkbSetBounceKeysDelay - Sets the BounceKeys delay for a key-
     board device

SYNOPSIS
     cc [ flag... ] file... -lX11 [ library... ]

     Bool XkbSetBounceKeysDelay (Display *display,  unsigned  int
          device_spec, unsigned int *delay);

ARGUMENTS
     - display
          connection to X server

     - device_spec
          device ID, or XkbUseCoreKbd

     - delay
          backfilled with bounce keys delay, ms

DESCRIPTION
     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
     ____________________________________________________________
     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 Events




X Version 11        Last change: libX11 1.3.5                   1






XKB FUNCTIONS                         XkbSetBounceKeysDelay(3x11)



     To receive XkbAccessXNotify events under all possible condi-
     tions,  use  XkbSelectEvents and pass XkbAccesXNotifyMask in
     both bits_to_change and values_for_bits.

     To receive XkbStateNotify events only under  certain  condi-
     tions,  use  XkbSelectEventDetails using XkbAccessXNotify as
     the 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
                                               wanted
     XkbAXN_SKAcceptMask              (1<<1)   Slow key  accept  notification
                                               wanted
     XkbAXN_SKRejectMask              (1<<2)   Slow key  reject  notification
                                               wanted
     XkbAXN_SKReleaseMask             (1<<3)   Slow key release  notification
                                               wanted
     XkbAXN_BKAcceptMask              (1<<4)   Bounce key accept notification
                                               wanted
     XkbAXN_BKRejectMask              (1<<5)   Bounce key reject notification
                                               wanted
     XkbAXN_AXKWarningMask            (1<<6)   AccessX  warning  notification
                                               wanted
     XkbAllAccessXEventsMask          (0x7f)   All AccessX features notifica-
                                               tions wanted

     Some users may accidentally "bounce"  on  a  key  when  they
     release  it.  They press it once, then accidentally press it
     again after they release it.  The  BounceKeys  control  tem-
     porarily  disables  a  key after it has been pressed, effec-
     tively "debouncing" the keyboard. The period of time the key
     is  disabled after it is released is known as the BounceKeys
     delay. BounceKeys is a boolean control.

     When the BounceKeys control is active,  the  server  reports
     acceptance  or rejection of any key to interested clients by
     sending an appropriate AccessXNotify event.

     XkbSetBounceKeysDelay  sends  a  request  to  configure  the
     BounceKeys  control  to  the  server. It does not wait for a
     reply and normally returns True. Specifying a value of  zero
     for the delay parameter causes XkbSetBounceKeysDelay to gen-
     erate a BadValue protocol error. If a compatible version  of
     the  Xkb  extension  is not available in the server, XkbSet-
     BounceKeysDelay returns False.





X Version 11        Last change: libX11 1.3.5                   2






XKB FUNCTIONS                         XkbSetBounceKeysDelay(3x11)



RETURN VALUES
     True           The  XkbSetBounceKeysDelay  function  returns
                    True when it sends a request to configure the
                    BounceKeys control to the server.

     False          The  XkbSetBounceKeysDelay  function  returns
                    False  if  a  compatible  version  of the Xkb
                    extension is not available in the server.

STRUCTURES
     The 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;


DIAGNOSTICS
     BadValue       An argument is out of range


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       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                   3