Man Linux: Main Page and Category List

NAME

       XkbGetIndicatorMap  -  Gets the map for one or more indicators, using a
       mask to specify the indicators

SYNOPSIS

       Status XkbGetIndicatorMap (Display *dpy, unsigned int which, XkbDescPtr
              desc);

ARGUMENTS

       - dpy  connection to the X server

       - which
              mask of indicators for which maps should be returned

       - desc keyboard description to be updated

DESCRIPTION

       Xkb  allows  applications  to obtain information about indicators using
       two different methods. The first method, which is similar to the core X
       implementation,  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.

       XkbGetIndicatorMap obtains the maps from  the  server  for  only  those
       indicators  specified  by the which mask and copies the values into the
       keyboard description specified by desc.  If the indicators field of the
       desc  parameter  is  NULL, XkbGetIndicatorMap allocates and initializes
       it.

       To free the indicator maps, use XkbFreeIndicatorMaps.

DIAGNOSTICS

       BadAlloc       Unable to allocate storage

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

       BadImplementation
                      Invalid reply from server

SEE ALSO

       XkbFreeIndicatorMaps(3), XkbGetNamedIndicators(3)