XkbGetCompatMap(3) XKB FUNCTIONS XkbGetCompatMap(3)
NAME
XkbGetCompatMap - Fetch any combination of the current compatibility
map components from the server
SYNOPSIS
Status XkbGetCompatMap (Display *display, unsigned int which, XkbDe-
scRec *xkb);
ARGUMENTS
display
connection to server
which mask of compatibility map components to fetch
xkb keyboard description where results placed
DESCRIPTION
When another client modifies the compatibility map, you are notified if
you have selected for XkbCompatMapNotify events. XkbGetCompatMap is
particularly useful when you receive an event of this type, as it al-
lows you to update your program's version of the compatibility map to
match the modified version now in the server. If your program is deal-
ing with multiple servers and needs to configure them all in a similar
manner, the updated compatibility map may be used to reconfigure other
servers.
XkbGetCompatMap fetches the components of the compatibility map speci-
fied in which from the server specified by display and places them in
the compat structure of the keyboard description xkb. Valid values for
which are an inclusive OR of the values shown in Table 1.
Table 1 Compatibility Map Component Masks
───────────────────────────────────────────────────────────────
Mask Value Affecting
───────────────────────────────────────────────────────────────
XkbSymInterpMask (1<<0) Symbol interpretations
XkbGroupCompatMask (1<<1) Group maps
XkbAllCompatMask (0x3) All compatibility map components
If no compatibility map structure is allocated in xkb upon entry, Xk-
bGetCompatMap allocates one. If one already exists, its contents are
overwritten with the returned results.
XkbGetCompatMap fetches compatibility map information for the device
specified by the device_spec field of xkb. Unless you have specifi-
cally modified this field, it is the default keyboard device. XkbGet-
CompatMap returns Success if successful, BadAlloc if it is unable to
obtain necessary storage for either the return values or work space,
BadMatch if the dpy field of the xkb argument is non-NULL and does not
match the display argument, and BadLength under certain conditions
caused by server or Xkb implementation errors.
DIAGNOSTICS
BadAlloc Unable to allocate storage
BadLength The length of a request is shorter or longer than that
required to minimally contain the arguments
BadMatch A compatible version of Xkb was not available in the
server or an argument has correct type and range, but is
otherwise invalid
X Version 11 libX11 1.8.4 XkbGetCompatMap(3)
Generated by dwww version 1.15 on Sun Jun 23 21:11:33 CEST 2024.