XKB FUNCTIONS XkbResizeKeyType(3x11)
NAME
XkbResizeKeyType - Change the number of levels in a key type
SYNOPSIS
cc [ flag... ] file... -lX11 [ library... ]
Status XkbResizeKeyType (XkbDescPtr xkb, int type_ndx, int
map_count, Bool want_preserve, int new_num_lvls);
ARGUMENTS- xkb
keyboard description containing client map to update- type_ndx
index in xkb->map->types of type to change
- map_count
total # of map entries needed for the type
- want_preserve
True => list of preserved modifiers is necessary- new_num_lvls
new max # of levels for type
DESCRIPTION
XkbResizeKeyType changes the type specified by xkb->map-
>types[type_ndx], and reallocates the symbols and actions
bound to all keys that use the type, if necessary.XkbResizeKeyType updates only the local copy of the types in
xkb; to update the server's copy for the physical device,use XkbSetMap or XkbChangeMap after calling XkbResizeKey-
Type.The map_count parameter specifies the total number of map
entries needed for the type, and can be zero or greater. Ifmap_count is zero, XkbResizeKeyType frees the existing map
and preserve entries for the type if they exist and sets them to NULL.The want_preserve parameter specifies whether a preserve
list for the key should be created. If want_preserve is
True, the preserve list with map_count entries is allocated
or reallocated if it already exists. Otherwise, ifwant_preserve is False, the preserve field is freed if
necessary and set to NULL.The new_num_lvls parameter specifies the new maximum number
of shift levels for the type and is used to calculate and resize the symbols and actions bound to all keys that use the type. X Version 11 Last change: libX11 1.3.5 1XKB FUNCTIONS XkbResizeKeyType(3x11)
If type_ndx does not specify a legal type, new_num_lvls is
less than 1, or the map_count is less than zero,
XkbResizeKeyType returns BadValue. If XkbResizeKeyType
encounters any problems with allocation, it returns BadAl-
loc. Otherwise, it returns Success.RETURN VALUES
Success The XkbResizeKeyType function returns Success
if type_ndx specifies a legal type,
new_num_lvls is greater than zero and
map_count is positive.
DIAGNOSTICS BadAlloc Unable to allocate storage BadValue An argument is out of rangeSEE ALSO
XkbChangeMap(3x11), XkbSetMap(3x11)ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | x11/library/libx11 ||_____________________________|_____________________________|
| Interface Stability | Committed ||_____________________________|_____________________________|
| MT-Level | See XInitThreads(3X11) |
|_____________________________|_____________________________|
X Version 11 Last change: libX11 1.3.5 2