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

FreeBSD Manual Pages

  
 
  

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

NAME
       XkbSetDetectableAutoRepeat - Sets DetectableAutoRepeat

SYNOPSIS

       Bool  XkbSetDetectableAutoRepeat	 (Display  *display,  Bool detectable,
	      Bool *supported_rtrn);

ARGUMENTS
       display
	      connection to X server

       detectable
	      True => set DetectableAutoRepeat

       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.

       This request affects all	keyboard activity for  the  requesting	client
       only;  other  clients  still see	the expected nondetectable auto-repeat
       behavior, unless	they have requested otherwise.

       XkbSetDetectableAutoRepeat sends	a request to the  server  to  set  De-
       tectableAutoRepeat on for the current client if detectable is True, and
       off  if	detectable  is	False;	it  then  waits	 for  a	reply. If sup-
       ported_rtrn is  not  NULL,  XkbSetDetectableAutoRepeat  backfills  sup-
       ported_rtrn  with True if the server supports DetectableAutoRepeat, and
       False if	it does	not.  XkbSetDetectableAutoRepeat returns  the  current
       state  of  DetectableAutoRepeat	for the	requesting client: True	if De-
       tectableAutoRepeat is set, and False otherwise.

RETURN VALUES
       True	      The XkbSetDetectableAutoRepeat function returns True  if
		      DetectableAutoRepeat is set.

       False	      The XkbSetDetectableAutoRepeat function returns False if
		      DetectableAutoRepeat is not set.

X Version 11			 libX11	1.8.12	 XkbSetDetectableAutoRepeat(3)

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

home | help