NAME¶
XkbCopyKeyTypes - Copy more than one XkbKeyTypeRec structure
SYNOPSIS¶
Status
XkbCopyKeyTypes (XkbKeyTypePtr from, XkbKeyTypePtr
into, int num_types);
ARGUMENTS¶
- - from
- pointer to array of XkbKeyTypeRecs to copy
- - into
- pointer to array of XkbKeyTypeRecs to change
- - num_types
- number of types to copy
DESCRIPTION¶
XkbCopyKeyTypes copies
num_types XkbKeyTypeRec structures from the
array specified by
from into the array specified by
into. It is
intended for copying between, rather than within, keyboard descriptions, so it
doesn't check for overlaps. The same rules that apply to the
from and
into parameters in
XkbCopyKeyType apply to each entry of the
from and
into arrays of
XkbCopyKeyTypes. If any
allocation errors occur while copying
from to
into,
XkbCopyKeyTypes returns BadAlloc. Otherwise,
XkbCopyKeyTypes copies
from to
into and returns Success.
RETURN VALUES¶
- Success
- The XkbCopyKeyTypes function returns Success when there are
no allocation errors.
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
SEE ALSO¶
XkbCopyKeyType(3)