NAME
XkbResizeKeyType - Change the number of levels in a key type SYNOPSIS Status XkbResizeKeyType (XkbDescPtr xkb, int typendx, int mapcount, Bool wantpreserve, int newnumlvls); ARGUMENTS
- xkb keyboard description containing client map to update
- typendx
index in xkb->map->types of type to change
- mapcount
total # of map entries needed for the type
- wantpreserve True => list of preserved modifiers is necessary
- newnumlvls
new max # of levels for type DESCRIPTION XkbResizeKeyType changes the type specified by
xkb->map->types[typendx], 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 call‐ ing XkbResizeKeyType. The mapcount parameter specifies the total number of map entries needed for the type, and can be zero or greater. If mapcount is zero, XkbResizeKeyType frees the existing map and preserve entries for the type if they exist and sets them to NULL. The wantpreserve parameter specifies whether a preserve list for the key should be created. If wantpreserve is True, the preserve list with mapcount entries is allocated or reallocated if it already exists. Otherwise, if wantpreserve is False, the preserve field is freed if necessary and set to NULL. The newnumlvls 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. If typendx does not specify a legal type, newnumlvls is less than 1, or the mapcount is less than zero, XkbResizeKeyType returns BadValue. If XkbResizeKeyType encounters any problems with allocation, it returns BadAlloc. Otherwise, it returns Success. RETURN VALUES Success The XkbResizeKeyType function returns Success if typendx specifies a legal type, newnumlvls is greater than zero and mapcount is positive. DIAGNOSTICS BadAlloc Unable to allocate storage BadValue An argument is out of range SEE ALSO XkbChangeMap(3), XkbSetMap(3) X Version 11 libX11 1.6.5 XkbResizeKeyType(3)