NAME¶
XkbCopyKeyType - Copy one XkbKeyTypeRec structures
SYNOPSIS¶
Status
XkbCopyKeyType (XkbKeyTypePtr from, XkbKeyTypePtr
into);
ARGUMENTS¶
- - from
- pointer to XkbKeyTypeRec to be copied
- - into
- pointer to XkbKeyTypeRec to be changed
DESCRIPTION¶
XkbCopyKeyType copies the key type specified by
from to the key
type specified by
into. Both must point to legal XkbKeyTypeRec
structures. Xkb assumes
from and
into point to different places.
As a result, overlaps can be fatal.
XkbCopyKeyType frees any existing
map, preserve, and
level_names in
into prior to copying.
If any allocation errors occur while copying
from to
into,
XkbCopyKeyType returns BadAlloc. Otherwise,
XkbCopyKeyType copies
from to
into and returns Success.
STRUCTURES¶
Key types are used to determine the shift level of a key given the current state
of the keyboard. The set of all possible key types for the Xkb keyboard
description are held in the
types field of the client map, whose total
size is stored in
size_types, and whose total number of valid entries
is stored in
num_types. Key types are defined using the following
structure:
typedef struct { /∗ Key Type */
XkbModsRec mods; /∗ modifiers used to compute shift level */
unsigned char num_levels; /∗ total # shift levels, do not modify directly */
unsigned char map_count; /∗ # entries in map, preserve (if non-NULL) */
XkbKTMapEntryPtr map; /∗ vector of modifiers for each shift level */
XkbModsPtr preserve; /∗ mods to preserve for corresponding map entry */
Atom name; /∗ name of key type */
Atom * level_names; /∗ array of names of each shift level */
} XkbKeyTypeRec, *XkbKeyTypePtr;
DIAGNOSTICS¶
- BadAlloc
- Unable to allocate storage