1XkbAllocGeometry(3) XKB FUNCTIONS XkbAllocGeometry(3)
2
3
4
6 XkbAllocGeometry - Allocate an entire geometry
7
9 Status XkbAllocGeometry (XkbDescPtr xkb, XkbGeometrySizesPtr sizes);
10
12 xkb keyboard description for which geometry is to be allocated
13
14 sizes initial sizes for all geometry components
15
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
38 BadAlloc Unable to allocate storage
39
40 BadValue An argument is out of range
41
43 XkbAllocKeyboard(3), XkbFreeGeometry(3), XkbGetKeyboard(3)
44
45
46
47
48X Version 11 libX11 1.8.7 XkbAllocGeometry(3)