Blob Blame History Raw
'\" t
...\" TabList.sgm /main/8 1996/09/08 21:08:47 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 "XmTabList" "library call"
.SH "NAME"
\fBXmTabList\fR \(em Data type for a tab list
.iX "XmTabList"
.SH "SYNOPSIS"
.PP
.nf
#include <Xm/Xm\&.h>
XmTabList
.fi
.SH "DESCRIPTION"
.PP
\fBXmTabList\fR is the data type for a tab list\&. A tab list consists
of tab stop list entries (\fBXmTab\fRs)\&. Whenever a tab component is
encountered while an \fBXmString\fR is being rendered, the origin of
the next X draw depends on the next \fBXmTab\fR\&. If a tab stop would
cause text to overlap, the x position for the segment is reset to
follow immediately after the end of the previous segment\&.
.PP
Tab lists are specified in resource files with the following syntax:
.PP
.nf
\fIresource_spec\fP\fB:\fP \fItab\fP WHITESPACE [, WHITESPACE \fItab\fP ]*
.fi
.PP
The resource value string consists of one or more tabs separated by
commas\&. Each \fItab\fP identifies the value of the tab, the unit
type, and whether the offset is relative or absolute\&. For example:
.PP
.nf
\fItab\fP := \fIfloat\fP [ WHITESPACE \fIunits\fP ]
\fIfloat\fP := [ \fIsign\fP ] [[ DIGIT]*\&. ]DIGIT+
\fIsign\fP := +
.fi
.PP
where the presence or absence of \fIsign\fP indicates, respectively, a
relative offset or an absolute offset\&. Note that negative tab values
are not allowed\&. \fIunits\fP indicates the unitType to use as
described in the \fBXmConvertUnits\fP reference page\&.
.PP
For example, the following specifies a tab list consisting of a one
inch absolute tab followed by a one inch relative tab:
.PP
.nf
\f(CW*tabList: 1in, +1in\fR
.fi
.PP
.PP
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\&.
.SH "RELATED"
.PP
Refer to the \fIMotif Programmer\&'s Guide\fP for more information about tabs and tab lists\&.
\fBXmTabListCopy\fP(3),
\fBXmTabListFree\fP(3),
\fBXmTabListGetTab\fP(3),
\fBXmTabListInsertTabs\fP(3),
\fBXmTabListRemoveTabs\fP(3),
\fBXmTabListReplacePositions\fP(3), and
\fBXmTabListTabCount\fP(3)\&.
...\" created by instant / docbook-to-man, Sun 22 Dec 1996, 20:32