XkbGetDeviceButtonActions(3) XKB FUNCTIONS XkbGetDeviceButtonActions(3)

NAME
       XkbGetDeviceButtonActions - Query the button actions associated with an
       X Input Extension device

SYNOPSIS
       Status  XkbGetDeviceButtonActions   (Display   *dpy,   XkbDeviceInfoPtr
              deviceinfo,   Bool   allbuttons,  unsigned  int  firstbutton,
              unsigned int numbuttons);

ARGUMENTS
       - dpy  connection to X server

       - deviceinfo
              structure to update with results

       - allbuttons
              True => get information for all buttons

       - firstbutton
              number of first button for which info is desired

       - numbuttons
              number of buttons for which info is desired

DESCRIPTION
       XkbGetDeviceButtonActions queries the server  for  the  desired  button
       information  for  the  device  indicated  by  the  devicespec field of
       deviceinfo and waits for a reply. If successful, XkbGetDeviceButtonAc‐
       tions  backfills the button actions (btnacts field of deviceinfo) for
       only the requested buttons, updates  the  name,  type,  supported,  and
       unsupported fields, and returns Success.

       allbuttons,  firstbutton  and  numbuttons specify the device buttons
       for which actions should  be  returned.  Setting  allbuttons  to  True
       requests  actions  for  all  device  buttons;  if allbuttons is False,
       firstbutton and numbuttons specify  a  range  of  buttons  for  which
       actions are requested.

       If  a  compatible  version of Xkb is not available in the server or the
       Xkb extension has not been properly initialized,  XkbGetDeviceButtonAc‐
       tions  returns BadAccess. If allocation errors occur, a BadAlloc status
       is returned. If  the  specified  device  (deviceinfo->devicespec)  is
       invalid,  a  BadKeyboard  status is returned. If the device has no but‐
       tons, a BadMatch status is returned. If  firstbutton  and  numbuttons
       specify illegal buttons, a BadValue status is returned.

DIAGNOSTICS
       BadAccess      The Xkb extension has not been properly initialized

       BadAlloc       Unable to allocate storage

       BadKeyboard    The  device  specified  was  not  a  valid core or input
                      extension device

       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



X Version 11                     libX11 1.6.5     XkbGetDeviceButtonActions(3)