'\" t
.\" TabCre.sgm /main/8 1996/09/08 21:08:31 rws $
.de P!
.fl
\!!1 setgray
.fl
\\&.\"
.fl
\!!0 setgray
.fl			\" force out current output buffer
\!!save /psv exch def currentpoint translate 0 0 moveto
\!!/showpage{}def
.fl			\" prolog
.sy sed -e 's/^/!/' \\$1\" bring in postscript file
\!!psv restore
.
.de pF
.ie     \\*(f1 .ds f1 \\n(.f
.el .ie \\*(f2 .ds f2 \\n(.f
.el .ie \\*(f3 .ds f3 \\n(.f
.el .ie \\*(f4 .ds f4 \\n(.f
.el .tm ? font overflow
.ft \\$1
..
.de fP
.ie     !\\*(f4 \{\
.	ft \\*(f4
.	ds f4\"
'	br \}
.el .ie !\\*(f3 \{\
.	ft \\*(f3
.	ds f3\"
'	br \}
.el .ie !\\*(f2 \{\
.	ft \\*(f2
.	ds f2\"
'	br \}
.el .ie !\\*(f1 \{\
.	ft \\*(f1
.	ds f1\"
'	br \}
.el .tm ? font underflow
..
.ds f1\"
.ds f2\"
.ds f3\"
.ds f4\"
.ta 8n 16n 24n 32n 40n 48n 56n 64n 72n 
.TH "XmTabCreate" 3
.SH "NAME"
\fBXmTabCreate\fP \(em A convenience function that creates a tab stop
"XmTabCreate"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Xm\&.h>
\fBXmTab \fBXmTabCreate\fP\fR(
\fBfloat \fBvalue\fR\fR,
\fBunsigned char \fBunits\fR\fR,
\fBXmOffsetModel \fBoffset_model\fR\fR,
\fBunsigned char \fBalignment\fR\fR,
\fBchar \fB*decimal\fR\fR);
.fi
.SH "DESCRIPTION"
.PP
\fBXmTabCreate\fP creates a tab stop at a position defined by the
\fIvalue\fP and \fIunits\fP arguments\&.
.IP "\fIvalue\fP" 10
Specifies the floating point value to be used in conjunction
with \fIunits\fP to calculate the location of the tab stop\&.
Note that negative values are not permitted\&.
.IP "\fIunits\fP" 10
Specifies the unit type (for example, \fBXmMILLIMETERS\fP)
to be used in conjunction with \fIvalue\fP
to calculate the location of the tab stop\&. You can specify
any unit described by the \fBXmConvertUnits\fP reference page\&.
For resources of type, dimension, or position, you can specify units
as described in the \fBXmNunitType\fP resource of the
\fBXmGadget\fP, \fBXmManager\fP, or \fBXmPrimitive\fP reference page\&.
.IP "\fIoffset_model\fP" 10
Specifies whether the tab value represents an absolute position or a
relative offset from the previous tab\&. Valid values are
\fBXmABSOLUTE\fP and \fBXmRELATIVE\fP\&.
.IP "\fIalignment\fP" 10
Specifies how the text should be aligned relative to this tab stop\&.
Valid values are \fBXmALIGNMENT_BEGINNING\fP\&.
.IP "\fIdecimal\fP" 10
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\&.
.SH "RETURN"
.PP
Returns a newly allocated \fBXmTab\fR\&.
The application is responsible for managing this allocated space\&.
The application can recover this allocated space by calling \fBXmTabFree\fP\&.
.SH "RELATED"
.PP
\fBXmTab\fP(3) and
\fBXmTabFree\fP(3)\&.
.\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:32