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
15              initial sizes for all geometry components
16

DESCRIPTION

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

DIAGNOSTICS

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

SEE ALSO

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