dwww Home | Manual pages | Find package

XkbGetIndicatorState(3)          XKB FUNCTIONS          XkbGetIndicatorState(3)

NAME
       XkbGetIndicatorState - Obtains the current state of the keyboard indica-
       tors

SYNOPSIS

       Status XkbGetIndicatorState (Display *display, unsigned int device_spec,
              unsigned int state_return);

ARGUMENTS
       display
              connection to the X server

       device_spec
              device ID, or XkbUseCoreKbd

       state_return
              backfilled with a mask of the indicator state

DESCRIPTION
       Xkb allows applications to obtain information about indicators using two
       different  methods. The first method, which is similar to the core X im-
       plementation, uses a mask to specify the indicators. The second  method,
       which is more suitable for applications concerned with interoperability,
       uses  indicator names. The correspondence between the indicator name and
       the bit position in masks is as follows: one of the parameters  returned
       from  XkbGetNamedIndicators  is an index that is the bit position to use
       in any function call that requires a mask of indicator bits, as well  as
       the indicator's index into the XkbIndicatorRec array of indicator maps.

       XkbGetIndicatorState queries the display for the state of the indicators
       on  the device specified by the device_spec.  For each indicator that is
       "turned on" on the device, the associated bit is  set  in  state_return.
       If  a  compatible  version  of the Xkb extension is not available in the
       server, XkbGetIndicatorState returns a  BadMatch  error.  Otherwise,  it
       sends  the  request  to the X server, places the state of the indicators
       into state_return, and returns Success. Thus the value reported  by  Xk-
       bGetIndicatorState is identical to the value reported by the core proto-
       col.

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

SEE ALSO
       XkbGetNamedIndicators(3)

X Version 11                     libX11 1.8.12          XkbGetIndicatorState(3)

Generated by dwww version 1.16 on Sat Oct 3 07:38:48 CEST 2026.