1. NAME▲
XkbGetKeyboard - Retrieves one or more components of a keyboard device description
2. SYNOPSIS ▲
XkbDescPtr XkbGetKeyboard (Display * display , unsigned int which , unsigned int device_spec );
3. ARGUMENTS ▲
- display
connection to the X server - device_spec
device ID, or XkbUseCoreKbd - bits_to_change
determines events to be selected / deselected - values_for_bits
1=>select, 0->deselect; for events in bits_to_change
4. DESCRIPTION ▲
XkbGetKeyboardallocates and returns a pointer to a keyboard description. It queries the server for those components specified in the whichparameter for device device_specand copies the results to the XkbDescRec it allocated. The remaining fields in the keyboard description are set to NULL. The valid masks for whichare those listed in Table 1.
c s s | ||
l l l | ||
Table 1 Mask Bits for XkbDescRec | ||
_ | ||
Mask Bit | XkbDescRec Field | Value |
_ | ||
XkbControlsMask | ctrls | (1L<<0) |
XkbServerMapMask | server | (1L<<1) |
XkbIClientMapMask | map | (1L<<2) |
XkbIndicatorMapMask | indicators | (1L<<3) |
XkbNamesMask | names | (1L<<4) |
XkbCompatMapMask | compat | (1L<<5) |
XkbGeometryMask | geom | (1L<<6) |
XkbAllComponentsMask | All Fields | (1L<<7) |
XkbGetKeyboardis used to read the current description for one or more components of a keyboard device. It calls XkbGetKeyboardByNameas follows: XkbGetKeyboardByName(dpy, device_spec,NULL, which, which,False).
5. DIAGNOSTICS ▲
- BadAlloc
Unable to allocate storage