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

FreeBSD Manual Pages


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

       XkbSelectEventDetails  -	 Selects or deselects for a specific Xkb event
       and optionally places conditions	on when	events of that	type  are  re-
       ported to your client

       Bool XkbSelectEventDetails (Display *display, unsigned int device_spec,
	      unsigned int event_type, unsigned	long int  bits_to_change,  un-
	      signed long int values_for_bits);

	      connection to the	X server

	      device ID, or XkbUseCoreKbd

	      Xkb event	type of	interest

	      determines events	to be selected / deselected

	      1=>select, 0->deselect; for events in bits_to_change

       Xkb  events  are	 selected using	an event mask, much the	same as	normal
       core X events are selected. However, unlike selecting  core  X  events,
       where  you must specify the selection status (on	or off)	for all	possi-
       ble event types whenever	you wish to change the selection criteria  for
       any one event, Xkb allows you to	restrict the specification to only the
       event types you wish to change. This means that you do not need to  re-
       member  the event selection values for all possible types each time you
       want to change one of them.

       Many Xkb	event types are	 generated  under  several  different  circum-
       stances.	When selecting to receive an Xkb event,	you may	specify	either
       that you	want it	delivered under	all circumstances, or that you want it
       delivered only for a subset of the possible circumstances.

       You  can	 also deselect an event	type that was previously selected for,
       using the same granularity.

       Xkb provides two	functions to  select  and  deselect  delivery  of  Xkb
       events.	 XkbSelectEvents  allows you to	select or deselect delivery of
       more than one Xkb event type at	once.  Events  selected	 using	XkbSe-
       lectEvents  are	delivered to your program under	all circumstances that
       generate	the events.  To	restrict delivery of an	event to a  subset  of
       the conditions under which it occurs, use XkbSelectEventDetails.	XkbSe-
       lectEventDetails	only allows you	to change the selection	conditions for
       a  single  event	 at a time, but	it provides a means of fine-tuning the
       conditions under	which the event	is delivered.

       To select or deselect for a specific Xkb	 event	and  optionally	 place
       conditions on when events of that type are reported to your client, use
       XkbSelectEventDetails.  This allows you to exercise a finer granularity
       of control over delivery	of Xkb events with XkbSelectEvents.

       While  XkbSelectEvents  allows  multiple	 events	to be selected,	XkbSe-
       lectEventDetails	changes	the selection criteria for a  single  type  of
       Xkb event. The interpretation of	the bits_to_change and values_for_bits
       masks depends on	the event type in question.

       XkbSelectEventDetails changes the Xkb event selection mask for the key-
       board   specified  by  device_spec  and	the  Xkb  event	 specified  by
       event_type.  To turn on event selection for an event  detail,  set  the
       bit  for	 the detail in the bits_to_change parameter and	set the	corre-
       sponding	bit in the values_for_bits parameter. To turn off event	detail
       selection   for	 a   detail,  set  the	bit  for  the  detail  in  the
       bits_to_change parameter	and do not set the corresponding  bit  in  the
       values_for_bits parameter.

       If  an  invalid	event type is specified, a BadValue protocol error re-
       sults. If a bit is not set in the  bits_to_change  parameter,  but  the
       corresponding  bit  is set in the values_for_bits parameter, a BadMatch
       protocol	error results. If an  undefined	 bit  is  set  in  either  the
       bits_to_change  or  the	values_for_bits	parameter, a BadValue protocol
       error results.

       For each	type of	Xkb event, the legal event details that	you can	 spec-
       ify  in	the  XkbSelectEventDetails  request are	listed in the chapters
       that describe each event	in detail.

       BadMatch	      A	compatible version of Xkb was  not  available  in  the
		      server or	an argument has	correct	type and range,	but is
		      otherwise	invalid

       BadValue	      An argument is out of range

       XkbSelectEvents(3), XkbUseCoreKbd(3)

X Version 11			 libX11	1.6.12	      XkbSelectEventDetails(3)


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

home | help