GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


NAME

       XkbAddGeomRow - Add a row to a section

SYNOPSIS

       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
       elements.

       The   top-level  geometry  description  includes  a  list  of  geometry
       properties.  A geometry property associates an arbitrary 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
       XkbAllocGeomRows function.

STRUCTURES

       typedef struct _XkbRow {
               short           top;
               short           left;
               unsigned short  num_keys;
               unsigned short  sz_keys;
               int             vertical;
               XkbKeyPtr       keys;
               XkbBoundsRec    bounds;
       } XkbRowRec, *XkbRowPtr;

SEE ALSO

       XkbAllocGeomRows(3)



  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to webmaster@gnu.wiki.
Page load time: 0.109 seconds. Last modified: November 04 2018 12:49:43.