NAME

       XmStringTableProposeTablist   —   A   convenience   function   that  returns  a  tab  list
       "XmStringTableProposeTablist"

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(3)