XmTabCreate(library call) XmTabCreate(library call)
NAME [Toc] [Back]
XmTabCreate - A convenience function that creates a tab stop
SYNOPSIS [Toc] [Back]
#include <Xm/Xm.h>
XmTab XmTabCreate(
float value,
unsigned char units,
XmOffsetModel offset_model,
unsigned char alignment,
char *decimal);
DESCRIPTION [Toc] [Back]
XmTabCreate creates a tab stop at a position defined by the value and
units arguments.
value Specifies the floating point value to be used in conjunction
with units to calculate the location of the tab stop. Note
that negative values are not permitted.
units Specifies the unit type (for example, XmMILLIMETERS) to be
used in conjunction with value to calculate the location of
the tab stop. You can specify any unit described by the
XmConvertUnits reference page. For resources of type,
dimension, or position, you can specify units as described
in the XmNunitType resource of the XmGadget, XmManager, or
XmPrimitive reference page.
offset_model
Specifies whether the tab value represents an absolute
position or a relative offset from the previous tab. Valid
values are XmABSOLUTE and XmRELATIVE.
alignment Specifies how the text should be aligned relative to this
tab stop. Valid values are XmALIGNMENT_BEGINNING.
decimal Specifies the multibyte character in the current language
environment to be used as the decimal point for a decimal
aligned tab stop. This is currently unused.
RETURN [Toc] [Back]
Returns a newly allocated XmTab. The application is responsible for
managing this allocated space. The application can recover this
allocated space by calling XmTabFree.
RELATED [Toc] [Back]
XmTab(3) and XmTabFree(3).
- 1 - Formatted: January 24, 2005 [ Back ] |
