1XkbFreeGeometry(3) XKB FUNCTIONS XkbFreeGeometry(3)
2
3
4
6 XkbFreeGeometry - Free an entire geometry
7
9 void XkbFreeGeometry (XkbGeometryPtr geom, unsigned int which, Bool
10 free_all);
11
13 geom geometry to be freed
14
15 which mask of geometry components to be freed
16
17 free_all
18 True => the entire geometry is freed
19
21 Xkb provides a number of functions to allocate and free subcomponents
22 of a keyboard geometry. Use these functions to create or modify key‐
23 board geometries. Note that these functions merely allocate space for
24 the new element(s), and it is up to you to fill in the values explic‐
25 itly in your code. These allocation functions increase sz_* but never
26 touch num_* (unless there is an allocation failure, in which case they
27 reset both sz_* and num_* to zero). These functions return Success if
28 they succeed, BadAlloc if they are not able to allocate space, or Bad‐
29 Value if a parameter is not as expected.
30
31 The values of which and free_all determine how much of the specified
32 geometry is freed. The valid values for which are:
33
34 #define XkbGeomPropertiesMask (1<<0)
35 #define XkbGeomColorsMask (1<<1)
36 #define XkbGeomShapesMask (1<<2)
37 #define XkbGeomSectionsMask (1<<3)
38 #define XkbGeomDoodadsMask (1<<4)
39 #define XkbGeomKeyAliasesMask (1<<5)
40 #define XkbGeomAllMask (0x3f)
41
42 If free_all is True, the entire geometry is freed regardless of the
43 value of which. Otherwise, the portions of the geometry specified by
44 which are freed.
45
47 BadAlloc Unable to allocate storage
48
49 BadValue An argument is out of range
50
51
52
53X Version 11 libX11 1.8.7 XkbFreeGeometry(3)