Man Linux: Main Page and Category List

NAME

       XkbFreeGeomOverlayRows - Free rows in an overlay

SYNOPSIS

       void  XkbFreeGeomOverlayRows  (XkbSectionPtr  overlay,  int  first, int
              count, Bool free_all);

ARGUMENTS

       - overlay
              section in which rows should be freed

       - first
              first row to be freed

       - count
              number of rows to be freed

       - free_all
              True => all rows are freed

DESCRIPTION

       Xkb provides a number of functions to allocate and  free  subcomponents
       of  a  keyboard  geometry.  Use  these  functions  to  create or modify
       keyboard geometries.  Note that these functions merely  allocate  space
       for  the  new  element(s),  and  it  is up to you to fill in the values
       explicitly in your code. These allocation functions increase  sz_*  but
       never touch num_* (unless there is an allocation failure, in which case
       they reset both sz_* and num_* to zero). These functions return Success
       if  they  succeed,  BadAlloc if they are not able to allocate space, or
       BadValue if a parameter is not as expected.

       If free_all is True, all rows are freed  regardless  of  the  value  of
       first  and count.  Otherwise, the number of rows specified by count are
       freed, beginning with the row  specified  by  first  in  the  specified
       overlay.

RETURN VALUES

       Success        The  XkbFreeGeomOverlayRows  function returns Success if
                      there are no allocation or argument errors.

DIAGNOSTICS

       BadAlloc       Unable to allocate storage

       BadValue       An argument is out of range