NAME
XkbGetKeySyms - Obtain the symbols for a subset of the keys in a
keyboard description
SYNOPSIS
Status XkbGetKeySyms (Display *dpy, unsigned int first, unsigned int
num, XkbDescPtr xkb);
ARGUMENTS
- dpy connection to X server
- first
keycode of first key to get
- num number of keycodes for which syms desired
- xkb Xkb description to be updated
DESCRIPTION
XkbGetKeySyms sends a request to the server to obtain the set of
keysyms bound to num keys starting with the key whose keycode is first.
It waits for a reply and returns the keysyms in the map.syms field of
xkb. If successful, XkbGetKeySyms returns Success. The xkb parameter
must be a pointer to a valid Xkb keyboard description.
If the client map in the xkb parameter has not been allocated,
XkbGetKeySyms allocates and initializes it before obtaining the
symbols.
If a compatible version of Xkb is not available in the server or the
Xkb extension has not been properly initialized, XkbGetKeySyms returns
BadAccess. If num is less than 1 or greater than XkbMaxKeyCount,
XkbGetKeySyms returns BadValue. If any allocation errors occur,
XkbGetKeySyms returns BadAlloc.
RETURN VALUES
Success The XkbGetKeySyms function returns Success if it gets a
reply to a request to the server to obtain the set of
keysyms bound to num keys starting with the key whose
keycode is first.
DIAGNOSTICS
BadAccess The Xkb extension has not been properly initialized
BadAlloc Unable to allocate storage
BadValue An argument is out of range