NAME
XkbGetDeviceButtonActions - Query the button actions associated with an
X Input Extension device
SYNOPSIS
Status XkbGetDeviceButtonActions (Display *dpy, XkbDeviceInfoPtr
device_info, Bool all_buttons, unsigned int first_button,
unsigned int num_buttons);
ARGUMENTS
- dpy connection to X server
- device_info
structure to update with results
- all_buttons
True => get information for all buttons
- first_button
number of first button for which info is desired
- num_buttons
number of buttons for which info is desired
DESCRIPTION
XkbGetDeviceButtonActions queries the server for the desired button
information for the device indicated by the device_spec field of
device_info and waits for a reply. If successful,
XkbGetDeviceButtonActions backfills the button actions (btn_acts field
of device_info) for only the requested buttons, updates the name, type,
supported, and unsupported fields, and returns Success.
all_buttons, first_button and num_buttons specify the device buttons
for which actions should be returned. Setting all_buttons to True
requests actions for all device buttons; if all_buttons is False,
first_button and num_buttons 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,
XkbGetDeviceButtonActions returns BadAccess. If allocation errors
occur, a BadAlloc status is returned. If the specified device
(device_info->device_spec) is invalid, a BadKeyboard status is
returned. If the device has no buttons, a BadMatch status is returned.
If first_button and num_buttons 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