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