Man Linux: Main Page and Category List

NAME

       XmStringTableProposeTablist — A convenience function that returns a tab
       list

SYNOPSIS

       #include <Xm/Xm.h>
       XmTabList XmStringTableProposeTablist(
       XmStringTable strings,
       Cardinal num_strings,
       Widget widget,
       float pad_value,
       XmOffsetModel offset_model);

DESCRIPTION

       XmStringTableProposeTablist takes an XmStringTable structure containing
       tabbed  compound  strings,  information on padding between columns, and
       rendering information and returns a tab list that, if  used  to  render
       the strings in the table, would cause the strings to line up in columns
       with no overlap and with the specified amount of  padding  between  the
       widest  item  in each column and the start of the next column. Each tab
       in the tablist would have the same unit type as units, an offset  model
       of offset_model, and an alignment type of XmALIGNMENT_BEGINNING.

       strings   Specifies an array of compound strings.

       num_strings
                 Specifies the number of compound strings in strings.

       widget    Specifies   the   widget  used  for  deriving  any  necessary
                 information for creating the rendition.  In  particular,  the
                 XmNunitType  of  widget will be used to specify the unit type
                 to be used in determining the amount  of  padding  separating
                 columns  and  for  the  tabs  in the proposed tab list. Also,
                 widget’s render table will be used in interpreting  rendition
                 tags within the strings.

       pad_value Specifies  the  value  of the amount of padding to be used to
                 separate columns.  The units for this parameter are specified
                 as  the  XmNunitType  set for the widget parameter.  Refer to
                 the XmNunitType  resource  of  the  XmGadget,  XmManager,  or
                 XmPrimitive reference page.

       offset_model
                 Specifies  the  offset model to be used in creating the tabs.
                 Can be XmABSOLUTE or XmRELATIVE.

RETURN

       Returns a new XmTabList.  The function  allocates  space  to  hold  the
       returned  tab  list.   The  application is responsible for managing the
       allocated space.  The application can recover the  allocated  space  by
       calling XmTabListFree.

RELATED

       XmTabList(3) and XmTabListFree(3).

                                     XmStringTableProposeTablist(library call)