dwww Home | Manual pages | Find package

XkbGetDetectableAutoRepeat(3)    XKB FUNCTIONS   XkbGetDetectableAutoRepeat(3)

NAME
       XkbGetDetectableAutoRepeat  - Determines whether or not the server sup-
       ports DetectableAutoRepeat

SYNOPSIS
       Bool   XkbGetDetectableAutoRepeat   (Display   *display,   Bool   *sup-
              ported_rtrn);

ARGUMENTS
       display
              connection to X server

       supported_rtrn
              backfilled True if DetectableAutoRepeat supported

DESCRIPTION
       Auto-repeat is the generation of multiple key events by a keyboard when
       the user presses a key and holds it down. Keyboard hardware and device-
       dependent  X  server software often implement auto-repeat by generating
       multiple KeyPress events with  no  intervening  KeyRelease  event.  The
       standard behavior of the X server is to generate a KeyRelease event for
       every KeyPress event. If the  keyboard  hardware  and  device-dependent
       software  of  the X server implement auto-repeat by generating multiple
       KeyPress events, the device-independent part of the X server by default
       synthetically  generates  a KeyRelease event after each KeyPress event.
       This provides predictable behavior for X clients, but  does  not  allow
       those clients to detect the fact that a key is auto-repeating.

       Xkb  allows clients to request detectable auto-repeat.  If a client re-
       quests and the  server  supports  DetectableAutoRepeat,  Xkb  generates
       KeyRelease  events  only  when  the  key is physically released. If De-
       tectableAutoRepeat is not supported or  has  not  been  requested,  the
       server synthesizes a KeyRelease event for each repeating KeyPress event
       it generates.

       DetectableAutoRepeat, unlike other controls, is not  contained  in  the
       XkbControlsRec structure, nor can it be enabled or disabled via the En-
       abledControls control.  Instead, query and set DetectableAutoRepeat us-
       ing XkbGetDetectableAutoRepeat and XkbSetDetectableAutoRepeat.

       DetectableAutoRepeat  is  a  condition that applies to all keyboard de-
       vices for a client's connection to a given X server; it cannot  be  se-
       lectively  set  for  some  devices and not for others. For this reason,
       none of the Xkb library functions  involving  DetectableAutoRepeat  in-
       volve a device specifier.

       XkbGetDetectableAutoRepeat  queries the server for the current state of
       DetectableAutoRepeat and waits for a reply. If  supported_rtrn  is  not
       NULL,  it backfills supported_rtrn with True if the server supports De-
       tectableAutoRepeat, and  False  otherwise.   XkbGetDetectableAutoRepeat
       returns  the  current  state of DetectableAutoRepeat for the requesting
       client: True if DetectableAutoRepeat is set, and False otherwise.

RETURN VALUES
       True           The XkbGetDetectableAutoRepeat function returns True  if
                      the server supports DetectableAutoRepeat.

       False          The XkbGetDetectableAutoRepeat function returns False if
                      the server does not support DetectableAutoRepeat.

X Version 11                     libX11 1.8.4    XkbGetDetectableAutoRepeat(3)

Generated by dwww version 1.15 on Sun Jun 23 21:16:08 CEST 2024.