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

FreeBSD Manual Pages


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

       XkbSetDetectableAutoRepeat - Sets DetectableAutoRepeat

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

       - display
	      connection to X server

       - detectable
	      True => set DetectableAutoRepeat

       - supported_rtrn
	      backfilled True if DetectableAutoRepeat supported

       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.

       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.7.2	 XkbSetDetectableAutoRepeat(3)


Want to link to this manual page? Use this URL:

home | help