XmColumn man page

XmColumn — The XmColumn widget class

Synopsis

#include <Xm/Column.h>

Description

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.

Version

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

Referenced By

XmVaCreateColumn(3).