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