XmColumn

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 Programmer’s 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 XmBulletinBoard’s 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 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.

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 child’s associated label. Valid values are the same as those for XmNdefaultEntryLabelAlignment.
XmNentryLabelFontList 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.

Translations and Actions

WARNINGS

VERSION

This manual page documents the XmColumn widget shipped in Motif version 2.2

AUTHOR

Edited by Kevin Cook.