1XkbAllocGeometry(3)              XKB FUNCTIONS             XkbAllocGeometry(3)
2
3
4

NAME

6       XkbAllocGeometry - Allocate an entire geometry
7

SYNOPSIS

9       Status XkbAllocGeometry (XkbDescPtr xkb, XkbGeometrySizesPtr sizes);
10

ARGUMENTS

12       xkb    keyboard description for which geometry is to be allocated
13
14       sizes  initial sizes for all geometry components
15

DESCRIPTION

17       Xkb  provides  a number of functions to allocate and free subcomponents
18       of a keyboard geometry. Use these functions to create  or  modify  key‐
19       board  geometries.  Note that these functions merely allocate space for
20       the new element(s), and it is up to you to fill in the  values  explic‐
21       itly  in  your code. These allocation functions increase sz_* but never
22       touch num_* (unless there is an allocation failure, in which case  they
23       reset  both  sz_* and num_* to zero). These functions return Success if
24       they succeed, BadAlloc if they are not able to allocate space, or  Bad‐
25       Value if a parameter is not as expected.
26
27       XkbAllocGeometry  allocates a keyboard geometry and adds it to the key‐
28       board description specified by xkb.  The keyboard description should be
29       obtained  via  the  XkbGetKeyboard  or  XkbAllocKeyboard functions. The
30       sizes parameter specifies the number of elements to be reserved for the
31       subcomponents  of  the keyboard geometry and can be zero or more. These
32       subcomponents include the properties,  colors,  shapes,  sections,  and
33       doodads.
34
35       To free an entire geometry, use XkbFreeGeometry.
36

DIAGNOSTICS

38       BadAlloc       Unable to allocate storage
39
40       BadValue       An argument is out of range
41

SEE ALSO

43       XkbAllocKeyboard(3), XkbFreeGeometry(3), XkbGetKeyboard(3)
44
45
46
47
48X Version 11                     libX11 1.8.7              XkbAllocGeometry(3)
Impressum