NAME
XkbFreeDeviceInfo - Free an XkbDeviceInfoRec structure SYNOPSIS void XkbFreeDeviceInfo (XkbDeviceInfoPtr deviceinfo, unsigned int which, Bool freeall); ARGUMENTS
- deviceinfo pointer to XkbDeviceInfoRec in which to free items
- which mask of components of deviceinfo to free
- freeall True => free everything, including deviceinfo DESCRIPTION If freeall is True, the XkbFreeDeviceInfo frees all components of deviceinfo and the XkbDeviceInfoRec structure pointed to by deviceinfo itself. If freeall is False, the value of which determines which subcomponents are freed. which is an inclusive OR of one or more of the values from Table 1. If which contains XkbXIButtonActionsMask, all button actions associated with deviceinfo are freed,
deviceinfo->btnacts is set to NULL, and deviceinfo->numbtns is set to zero. If which contains all bits in XkbXIIndicatorsMask, all XkbDe‐ viceLedInfoRec structures associated with deviceinfo are freed,
deviceinfo->leds is set to NULL, and deviceinfo->szleds and
deviceinfo->numleds are set to zero. If which contains XkbXIIndica‐ torMapsMask, all indicator maps associated with deviceinfo are cleared, but the number of LEDs and the leds structures themselves is preserved. If which contains XkbXIIndicatorNamesMask, all indicator names associated with deviceinfo are cleared, but the number of LEDs and the leds structures themselves is preserved. If which contains XkbXIIndicatorStateMask, the indicator state associated with the deviceinfo leds are set to zeros but the number of LEDs and the leds structures themselves is preserved. Table 1 XkbDeviceInfoRec Mask Bits Name XkbDeviceInfoRec Value Capability If Set Fields Effected XkbXIKeyboardsMask (1L <<0) Clients can use all Xkb requests and events with KeyClass devices supported by the input device extension. XkbXIButtonActionsMask numbtns (1L <<1) Clients can assign key btnacts actions to buttons
non-KeyClass input extension devices.
XkbXIIndicatorNamesMask leds->names (1L <<2) Clients can assign names to indicators on
non-KeyClass input extension devices.
XkbXIIndicatorMapsMask leds->maps (1L <<3) Clients can assign indicator maps to indicators on
non-KeyClass input extension devices.
XkbXIIndicatorStateMask leds->state (1L <<4) Clients can request the status of indicators
on non-KeyClass input extension devices. XkbXIIndicatorsMask szleds (0x1c) XkbXIIndicatorNamesMask | numleds XkbXIIndicatorMapsMask |
leds->* XkbXIIndicatorStateMask XkbXIUnsupportedFeaturesMask unsupported (1L <<15) XkbXIAllDeviceFeaturesMask Those selected (0x1e) XkbXIIndicatorsMask | by Value Column XkbSIButtonActionsMask masks XkbXIAllFeaturesMask Those selected (0x1f) XkbSIAllDeviceFeaturesMask | by Value Column XkbSIKeyboardsMask masks XkbXIAllDetailsMask Those selected (0x801f) XkbXIAllFeaturesMask | by Value column XkbXIUnsupportedFeaturesMask masks 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 devicespec; /∗ device of interest */ Bool hasownstate; /∗ True=>this device has its own state */ unsigned short supported; /∗ bits indicating supported capabilities */ unsigned short unsupported; /∗ bits indicating unsupported capabilities */ unsigned short numbtns; /∗ number of entries in btnacts */ XkbAction * btnacts; /∗ button actions */ unsigned short szleds; /∗ total number of entries in LEDs vector */ unsigned short numleds; /∗ number of valid entries in LEDs vector */ unsigned short dfltkbdfb; /∗ input extension ID of default (core kbd) indicator */ unsigned short dfltledfb; /∗ input extension ID of default indicator feedback */ XkbDeviceLedInfoPtr leds; /∗ LED descriptions */ } XkbDeviceInfoRec, *XkbDeviceInfoPtr; typedef struct { unsigned short ledclass; /∗ class for this LED device*/ unsigned short ledid; /∗ ID for this LED device */ unsigned int physindicators; /∗ bits for which LEDs physically present */ unsigned int mapspresent; /∗ bits for which LEDs have maps in maps */ unsigned int namespresent; /∗ bits for which LEDs are in names */ unsigned int state; /∗ 1 bit => corresponding LED is on */ Atom names[XkbNumIndicators]; /∗ names for LEDs */ XkbIndicatorMapRec maps; /∗ indicator maps for each LED */ } XkbDeviceLedInfoRec, *XkbDeviceLedInfoPtr; X Version 11 libX11 1.6.5 XkbFreeDeviceInfo(3)