XmStringTableProposeTablisUNIX)SysXmStringTableProposeTablist(3X)
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);
VERSION
This page documents Motif 2.1.
DESCRIPTION
XmStringTableProposeTablist takes an XmStringTablestructure
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
Page 1 (printed 7/20/06)
XmStringTableProposeTablisUNIX)SysXmStringTableProposeTablist(3X)
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).
Page 2 (printed 7/20/06)
