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)