NAME
XmColumn - The XmColumn Widget Class
SYNOPSIS
#include <Xm/Column.h>
DESCRIPTION
The Column widget displays its children stacked in a column, each with
an optional associated label: labels appear in one column, and children
in another. This is useful for displaying, for example, labeled data-
entry fields. It can also display all label-child pairs in a
horizontal orientation.This widget offers several constraint resources
that allow specification of characteristics of the label, such as
displaying text or a pixmap, alignment of text, font to use, and so
forth. It also offers several resources for setting defaults for
children that specify no specic values.
Classes
Column inherits behavior and resources from Core, Composite,
Constraint, XmManager, and XmBulletinBoard. For a complete description
of each resource, refer to the OSF/Motif Programmers Reference.
Resources
Resources
XmNdefaultEntryLabelAlignment Specifies the default
XmNentryLabelAlignment to use when a child specifies no significant
value. Resources that specify Alignment have values of
XmALIGNMENT_BEGINNING,
XmALIGNMENT_CENTER, XmALIGNMENT_END, and XmALIGNMENT_UNSPECIFIED.
Valid string values that can be used in a resources file are:
alignment_unspecified, unspecified, alignment_beginning, beginning,
alignment_center, center, alignment_end, end.
XmNdefaultEntryLabelFontList Specifies the default
XmNentryLabelFontList to use when a child specifies no significant
value. If unspecified, uses the XmBulletinBoards XmNlabelFontList
resource.
XmNdefaultFillStyle Specifies the default XmNfillStyle to use when a
child specifies no significant value.
XmNdistribution Specifies whether the spacing between each pair of rows
should be increased equally (XmDISTRIBUTE_SPREAD) or remain constant
(XmDISTRIBUTE_TIGHT) when the column is resized vertically to be larger
than its natural size. This resource has no effect if any child has its
XmNstretchable resource set to True. This resource is valid only when
the orientation is vertical.
XmNitemSpacing Specifies the spacing between each pair of rows (in
vertical orientation) or between pairs of labels and children (in
horizontal orientation).
XmNlabelSpacing Specifies the spacing between the column containing the
labels and the column containing the XmColumns children.
XmNorientation Specifies the layout direction of the XmColumn. When
XmVERTICAL, the widgets and their associated labels are laid out in two
vertical columns. When XmHORIZONTAL, the widgets and their associated
labels are laid out in a single row.
Constraint Resources
the XmColumn. These resources are derived from those supported by
XmLabel; see the manual page for XmLabel for valid values and usage.
XmNentryLabelAlignment Specifies justification of text within the
childs associated label. Valid values are the same as those for
XmNdefaultEntryLabelAlignment.
XmNentryLabelFontList Specifies fontList used to render the text within
the childs associated label.
XmNentryLabelPixmap Specifies the pixmap used in the childs associated
label.
XmNentryLabelString Specifies the text used in the childs associated
label.
XmNentryLabelType Specifies whether to display a string (XmSTRING) or a
pixmap (XmPIXMAP) in the childs associated label.
XmNfillStyle Specifies whether the child should be displayed at its
natural size (XmFILL_RAGGED) or stretched to fill the entire width of
the column it is displayed within (XmFILL_FLUSH).
XmFILL_UNSPECIFIED uses the value of the XmColumns XmNdefaultFillStyle.
XmNshowEntryLabel Specifies whether or not to display the childs
associated label.
XmNstretchable Specifies whether the child should expand in size
proportionately when the XmColumn is resized vertically to be larger
than its natural size.
Translations and Actions
SEE ALSO
WARNINGS
VERSION
This manual page documents the XmColumn widget shipped in Motif version
2.2
AUTHOR
(c) 2002 by Integrated Computer Solutions, Inc.
Edited by Kevin Cook.