XmColumn 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
XmColumn inherits behavior and resources from Core, Composite, Constraint, XmManager, and XmBulletinBoard.
The class pointer is xmColumnWidgetClass.
The class name is XmColumn.
New Resources
The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the
inherited classes to set attributes for this widget. To reference a resource
by name or by class in a .Xdefaults file, remove the XmN or
XmC prefix and use the remaining letters (in either lowercase or
uppercase, but include any underscores between words). The codes in
the access column indicate if the given resource can be at createion time (C),
or is not applicable (N/A).
XmColumn Resource Set
Name
Class
Type
Default
Access
XmNdefaultEntryLabelAlignment
XmCAlignment
unsigned char
XmALIGNMENT_BEGINNING
CSG
XmNdefaultEntryLabelFontList
XmCFontList
XmRFontList
dynamic
CGS
XmNdefaultEntryLabelRenderTable
XmCRendertable
XmRFontList
dynamic
CGS
XmNdefaultFillStyle
XmCFillStyle
unsigned char
XmFILL_RAGGED
CGS
XmNdistribution
XmCDistribution
unsigned char
XmDISTRIBUTE_TIGHT
CGS
XmNitemSpacing
XmCItemSpacing
Dimension
2
CSG
XmNlabelSpacing
XmCLabelSpacing
Dimentsion
10
CSG
XmNorientation
XmCOrientation
unsigned char
XmVERTICAL
CSG
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 XmNlabelFontList resource of the XmBulletinBoard.
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
XmColumn's 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.
The visual appearance of columns is affected by setting constraint resources on the children of
the XmColumn.
These resources are derived from those supported by XmLabel; see the manual page for XmLabel
for valid values and usage.
XmColumn Constraint Resource Set
Name
Class
Type
Default
AccessfP
XmNentryLabelAlignment
XmCAlignment
unsigned char
XmALIGNMENT_UNSPECIFIED
CSG
XmNentryLabelFontList
XmCFontList
XmFontList
dynamic
CSG
XmNentryLabelRenderTable
XmCRenderTable
XmRenderTable
dynamic
CSG
XmNentryLabelPixmap
XmCLabelPixmap
Pixmap
XmUNPECIFIED_PIXMAP
CSG
XmNentryLabelString
XmCLabelString
XmString
NULL
CSG
XmNentryLabelType
XmCLabelType
unsigned char
XmSTRING
CSG
XmNfillStyle
XmCFillStyle
unsigned char
XmFILL_UNSPECIFIED
CSG
XmNshowEntryLabel
XmCShowLabel
Boolean
True
CSG
XmNstretchable
XmCStretchable
Boolean
False
CG
XmNentryLabelAlignment
Specifies justification of text within the child's associated label. Valid values are the same as
those for XmNdefaultEntryLabelAlignment.
mNentryLabelFontList
Specifies fontList used to render the text within the child's associated label.
XmNentryLabelPixmap
Specifies the pixmap used in the child's associated label.
XmNentryLabelString
Specifies the text used in the child's associated label.
XmNentryLabelType
Specifies whether to display a string (XmSTRING) or a pixmap (XmPIXMAP) in the child's
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 XmColumn's XmNdefaultFillStyle.
XmNshowEntryLabel
Specifies whether or not to display the child's 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.