Manual Pages for UNIX Operating System command usage for man XkbSelectEventDetails

XKB FUNCTIONS                         XkbSelectEventDetails(3x11)



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
     cc [ flag... ] file... -lX11 [ library... ]

     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  selec-
     tion  status  (on or off) for all possible event types when-
     ever 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 pos-
     sible 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 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 XkbSelectEvents are delivered to your



X Version 11        Last change: libX11 1.3.5                   1






XKB FUNCTIONS                         XkbSelectEventDetails(3x11)



     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.  XkbSelec-
     tEventDetails only allows you to change the selection condi-
     tions 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  option-
     ally  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,
     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  corresponding  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  results.  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  specify in the XkbSelectEventDetails 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(3x11), XkbUseCoreKbd(3x11)




X Version 11        Last change: libX11 1.3.5                   2






XKB FUNCTIONS                         XkbSelectEventDetails(3x11)



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|










































X Version 11        Last change: libX11 1.3.5                   3