NAME¶
XkbResizeDeviceButtonActions - Allocate additional space for button actions in
an XkbDeviceInfoRec structure
SYNOPSIS¶
Status XkbResizeDeviceButtonActions (XkbDeviceInfoPtr
device_info, unsigned int
new_total);
ARGUMENTS¶
- - device_info
- structure in which to allocate button actions
- - new_total
- new total number of button actions needed
DESCRIPTION¶
XkbResizeDeviceButtonActions reallocates space, if necessary, to make
sure there is room for a total of
new_total button actions in the
device_info structure. Any new entries allocated are zeroed. If
successful,
XkbResizeDeviceButtonActions returns Success. If
new_total is zero, all button actions are deleted,
device_info->num_btns is set to zero, and
device_info->btn_acts is set to NULL. If
device_info is
invalid or
new_total is greater than 255, BadValue is returned. If a
memory allocation failure occurs, a BadAlloc is returned.
To free an XkbDeviceInfoRec structure, use
XkbFreeDeviceInfo.
STRUCTURES¶
Information about X Input Extension devices is transferred between a client
program and the Xkb extension in an XkbDeviceInfoRec structure:
typedef struct {
char * name; /∗ name for device */
Atom type; /∗ name for class of devices */
unsigned short device_spec; /∗ device of interest */
Bool has_own_state; /∗ True=>this device has its own state */
unsigned short supported; /∗ bits indicating supported capabilities */
unsigned short unsupported; /∗ bits indicating unsupported capabilities */
unsigned short num_btns; /∗ number of entries in btn_acts */
XkbAction * btn_acts; /∗ button actions */
unsigned short sz_leds; /∗ total number of entries in LEDs vector */
unsigned short num_leds; /∗ number of valid entries in LEDs vector */
unsigned short dflt_kbd_fb; /∗ input extension ID of default (core kbd) indicator */
unsigned short dflt_led_fb; /∗ input extension ID of default indicator feedback */
XkbDeviceLedInfoPtr leds; /∗ LED descriptions */
} XkbDeviceInfoRec, *XkbDeviceInfoPtr;
DIAGNOSTICS¶
- BadAlloc
- Unable to allocate storage
- BadValue
- An argument is out of range
SEE ALSO¶
XkbFreeDeviceInfo(3)