XmTabCreate(3X) UNIX System V XmTabCreate(3X)
NAME
XmTabCreate - A convenience function that creates a tab stop
SYNOPSIS
#include <Xm/Xm.h>
XmTab XmTabCreate(
float value,
unsigned char units,
XmOffsetModel offset_model,
unsigned char alignment,
char *decimal);
VERSION
This page documents Motif 2.1.
DESCRIPTION
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
valueto 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
Returns a newly allocated XmTab. The application is
responsible for managing this allocated space. The
Page 1 (printed 7/20/06)
XmTabCreate(3X) UNIX System V XmTabCreate(3X)
application can recover this allocated space by calling
XmTabFree.
RELATED
XmTab(3) and XmTabFree(3).
Page 2 (printed 7/20/06)
