XkbSelectEventDetails(3) - phpMan

Command: man perldoc info search(apropos)  


XkbSelectEventDetails(3)                  XKB FUNCTIONS                  XkbSelectEventDetails(3)



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

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

ARGUMENTS
       display
              connection to the X server

       device_spec
              device ID, or XkbUseCoreKbd

       event_type
              Xkb event type of interest

       bits_to_change
              determines events to be selected / deselected

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

DESCRIPTION
       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 possible 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 remember 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 circumstances.  When  selecting
       to  receive an Xkb event, you may specify either that you want it delivered under all cir-
       cumstances, 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 gran-
       ularity.

       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 XkbSelectEvents 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.  XkbSelectEventDetails  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 XkbSe-
       lectEvents.

       While XkbSelectEvents allows multiple events to be selected, XkbSelectEventDetails 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 keyboard  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  cor-
       responding  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 cor-
       responding bit in the values_for_bits parameter.

       If  an invalid event type is specified, a BadValue protocol error results. If a bit is not
       set in the bits_to_change parameter,  but  the  corresponding  bit  is  set  in  the  val-
       ues_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 specify in the XkbSe-
       lectEventDetails request are listed in the chapters that describe each event in detail.

DIAGNOSTICS
       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

SEE ALSO
       XkbSelectEvents(3), XkbUseCoreKbd(3)



X Version 11                               libX11 1.6.7                  XkbSelectEventDetails(3)

Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2024-04-25 17:48 @18.116.42.208 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)
Valid XHTML 1.0!Valid CSS!