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, over‐ laps can be fatal. XkbCopyKeyType frees any existing map, preserve, and levelnames in into prior to copying. If any allocation errors occur while copying from to into, XkbCopyKeyType returns BadAlloc. Oth‐ erwise, XkbCopyKeyType copies from to into and returns Success. STRUCTURES Key types are used to determine the shift level of a key given the cur‐ rent 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 sizetypes, and whose total number of valid entries is stored in numtypes. Key types are defined using the following structure: typedef struct { /∗ Key Type */ XkbModsRec mods; /∗ modifiers used to compute shift level */
unsigned char numlevels; /∗ total # shift levels, do not modify directly */
unsigned char mapcount; /∗ # 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 * levelnames; /∗ array of names of each shift level */ } XkbKeyTypeRec, *XkbKeyTypePtr; DIAGNOSTICS BadAlloc Unable to allocate storage X Version 11 libX11 1.6.5 XkbCopyKeyType(3)