Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XkbGetDetectableAutoRepeat(3)	  XKB FUNCTIONS    XkbGetDetectableAutoRepeat(3)

NAME
     XkbGetDetectableAutoRepeat  - Determines whether or not the server supports
     DetectableAutoRepeat

SYNOPSIS
     Bool XkbGetDetectableAutoRepeat (Display *display, Bool *supported_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-depen-
     dent  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  im-
     plement  auto-repeat by generating multiple KeyPress events, the device-in-
     dependent part of the X server by default synthetically generates a  KeyRe-
     lease  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 requests
     and  the  server  supports  DetectableAutoRepeat,	Xkb generates KeyRelease
     events only when the key is physically released. If DetectableAutoRepeat is
     not supported or has not been requested, the server  synthesizes  a  KeyRe-
     lease event for each repeating KeyPress event it generates.

     DetectableAutoRepeat,  unlike  other controls, is not contained in the Xkb-
     ControlsRec structure, nor can it be enabled or disabled via  the	Enabled-
     Controls  control.   Instead,  query and set DetectableAutoRepeat using Xk-
     bGetDetectableAutoRepeat and XkbSetDetectableAutoRepeat.

     DetectableAutoRepeat is a condition that applies to  all  keyboard  devices
     for a client's connection to a given X server; it cannot be selectively set
     for  some	devices and not for others. For this reason, none of the Xkb li-
     brary functions involving DetectableAutoRepeat involve a device specifier.

     XkbGetDetectableAutoRepeat queries the server for the current state of  De-
     tectableAutoRepeat and waits for a reply. If supported_rtrn is not NULL, it
     backfills supported_rtrn with True if the server supports DetectableAutoRe-
     peat,  and False otherwise.  XkbGetDetectableAutoRepeat returns the current
     state of DetectableAutoRepeat  for  the  requesting  client:  True  if  De-
     tectableAutoRepeat 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.13    XkbGetDetectableAutoRepeat(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XkbGetDetectableAutoRepeat&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help