Manual Pages for UNIX Operating System command usage for man XkbAddGeomRow

XKB FUNCTIONS                                 XkbAddGeomRow(3x11)



NAME
     XkbAddGeomRow - Add a row to a section

SYNOPSIS
     cc [ flag... ] file... -lX11 [ library... ]

     XkbRowPtr   XkbAddGeomRow   (XkbSectionPtr   section,    int
          sz_keys);

ARGUMENTS
     - section
          section to be updated

     - sz_keys
          number of keys to be reserved

DESCRIPTION
     Xkb provides functions to add a single new  element  to  the
     top-level  keyboard geometry. In each case the num_ * fields
     of the corresponding structure is incremented  by  1.  These
     functions do not change sz_* unless there is no more room in
     the array. Some of these functions fill in the values of the
     element's structure from the arguments. For other functions,
     you must explicitly write code to fill the structure's  ele-
     ments.

     The  top-level  geometry  description  includes  a  list  of
     geometry properties. A geometry property associates an arbi-
     trary string with an equally arbitrary name.  Programs  that
     display  images  of keyboards can use geometry properties as
     hints, but  they  are  not  interpreted  by  Xkb.  No  other
     geometry structures refer to geometry properties.

     One of the components of a keyboard geometry section is  one
     or  more  rows  of  keys.  XkbAddGeomRow adds one row to the
     specified section. The newly created row contains space  for
     the  number of keys specified in sz_keys. They are allocated
     and  zeroed,  but  otherwise  uninitialized.   XkbAddGeomRow
     returns  NULL if any of the parameters is empty or if it was
     not able to allocate space for the row.  To  allocate  space
     for an arbitrary number of rows to a section, use the XkbAl-
     locGeomRows function.

STRUCTURES
     typedef struct _XkbRow {
             short           top;
             short           left;
             unsigned short  num_keys;
             unsigned short  sz_keys;
             int             vertical;
             XkbKeyPtr       keys;
             XkbBoundsRec    bounds;



X Version 11        Last change: libX11 1.3.5                   1






XKB FUNCTIONS                                 XkbAddGeomRow(3x11)



     } XkbRowRec, *XkbRowPtr;

SEE ALSO
     XkbAllocGeomRows(3x11)


ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | x11/library/libx11          |
    |_____________________________|_____________________________|
    | Interface Stability         | Committed                   |
    |_____________________________|_____________________________|
    | MT-Level                    | See XInitThreads(3X11)      |
    |_____________________________|_____________________________|




































X Version 11        Last change: libX11 1.3.5                   2