1XmColumn(library call) XmColumn(library call)
2
6 XmColumn — The XmColumn widget class
7
9 #include <Xm/Column.h>
10
12 XmColumn displays its children stacked in a column, each with an
13 optional associated label: labels appear in one column, and children in
14 another. This is useful for displaying, for example, labeled data-entry
15 fields. It can also display all label-child pairs in a horizontal ori‐
16 entation.This widget offers several constraint resources that allow
17 specification of characteristics of the label, such as displaying text
18 or a pixmap, alignment of text, font to use, and so forth. It also
19 offers several resources for setting defaults for children that specify
20 no specic values.
21
23 XmColumn inherits behavior and resources from Core, Composite, Con‐
24 straint, XmManager, and XmBulletinBoard.
25 The class pointer is xmColumnWidgetClass.
27 The class name is XmColumn.
29 New Resources
31 The following table defines a set of widget resources used by the pro‐
32 grammer to specify data. The programmer can also set the resource val‐
33 ues for the inherited classes to set attributes for this widget. To
34 reference a resource by name or by class in a .Xdefaults file, remove
35 the XmN or XmC prefix and use the remaining letters (in either lower‐
36 case or uppercase, but include any underscores between words). The
37 codes in the access column indicate if the given resource can be at
38 createion time (C), or is not applicable (N/A).
39 ┌───────────────────────────────────────────────────────────────────────────────────────────────────┐
41 │ │ XmColumn Res│ource Set │ │ │
42 │Name │ Class │ Type │ Default │ Access │
43 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
44 │XmNdefaultEntryLabelAlignment │ XmCAlignment │ unsigned char │ XmALIGNMENT_BEGINNING │ CSG │
45 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
46 │XmNdefaultEntryLabelFontList │ XmCFontList │ XmRFontList │ dynamic │ CGS │
47 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
48 │XmNdefaultEntryLabelRenderTable │ XmCRendertable │ XmRFontList │ dynamic │ CGS │
49 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
50 │XmNdefaultFillStyle │ XmCFillStyle │ unsigned char │ XmFILL_RAGGED │ CGS │
51 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
52 │XmNdistribution │ XmCDistribution │ unsigned char │ XmDISTRIBUTE_TIGHT │ CGS │
53 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
54 │XmNitemSpacing │ XmCItemSpacing │ Dimension │ 2 │ CSG │
55 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
56 │XmNlabelSpacing │ XmCLabelSpacing │ Dimentsion │ 10 │ CSG │
57 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
58 │XmNorientation │ XmCOrientation │ unsigned char │ XmVERTICAL │ CSG │
59 ├────────────────────────────────┼─────────────────┼───────────────┼───────────────────────┼────────┤
60 └────────────────────────────────┴─────────────────┴───────────────┴───────────────────────┴────────┘
61 XmNdefaultEntryLabelAlignment
62 Specifies the default XmNentryLabelAlignment to use when a
63 child specifies no significant value. Resources that specify
64 Alignment have values of XmALIGNMENT_BEGINNING,
65 XmALIGNMENT_CENTER, XmALIGNMENT_END, and XmALIGNMENT_UNSPECI‐
66 FIED. Valid string values that can be used in a resources
67 file are: alignment_unspecified, unspecified, align‐
68 ment_beginning, beginning, alignment_center, center, align‐
69 ment_end, end.
70 XmNdefaultEntryLabelFontList
72 Specifies the default XmNentryLabelFontList to use when a
73 child specifies no significant value. If unspecified, uses
74 XmNlabelFontList resource of the XmBulletinBoard.
75 XmNdefaultFillStyle
77 Specifies the default XmNfillStyle to use when a child speci‐
78 fies no significant value.
79 XmNdistribution
81 Specifies whether the spacing between each pair of rows
82 should be increased equally (XmDISTRIBUTE_SPREAD) or remain
83 constant (XmDISTRIBUTE_TIGHT) when the column is resized ver‐
84 tically to be larger than its natural size. This resource has
85 no effect if any child has its
86 XmNstretchable resource set to True. This resource is valid
87 only when the orientation is vertical.
88 XmNitemSpacing
90 Specifies the spacing between each pair of rows (in vertical
91 orientation) or between pairs of labels and children (in hor‐
92 izontal orientation).
93 XmNlabelSpacing
95 Specifies the spacing between the column containing the
96 labels and the column containing the XmColumn's children.
97 XmNorientation
99 Specifies the layout direction of the XmColumn. When XmVERTI‐
100 CAL, the widgets and their associated labels are laid out in
101 two vertical columns. When XmHORIZONTAL, the widgets and
102 their associated labels are laid out in a single row.
103 The visual appearance of columns is affected by setting constraint
107 resources on the children of the XmColumn. These resources are derived
108 from those supported by XmLabel; see the manual page for XmLabel for
109 valid values and usage.
110 ┌───────────────────────────────────────────────────────────────────────────────────────────────┐
112 │ │ XmColumn Co│nstraint Resourc│e Set │ │
113 │Name │ Class │ Type │ Default │ AccessfP │
114 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
115 │XmNentryLabelAlignment │ XmCAlignment │ unsigned char │ XmALIGNMENT_UNSPECIFIED │ CSG │
116 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
117 │XmNentryLabelFontList │ XmCFontList │ XmFontList │ dynamic │ CSG │
118 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
119 │XmNentryLabelRenderTable │ XmCRenderTable │ XmRenderTable │ dynamic │ CSG │
120 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
121 │XmNentryLabelPixmap │ XmCLabelPixmap │ Pixmap │ XmUNPECIFIED_PIXMAP │ CSG │
122 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
123 │XmNentryLabelString │ XmCLabelString │ XmString │ NULL │ CSG │
124 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
125 │XmNentryLabelType │ XmCLabelType │ unsigned char │ XmSTRING │ CSG │
126 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
127 │XmNfillStyle │ XmCFillStyle │ unsigned char │ XmFILL_UNSPECIFIED │ CSG │
128 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
129 │XmNshowEntryLabel │ XmCShowLabel │ Boolean │ True │ CSG │
130 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
131 │XmNstretchable │ XmCStretchable │ Boolean │ False │ CG │
132 ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
133 └─────────────────────────┴────────────────┴───────────────┴─────────────────────────┴──────────┘
134 XmNentryLabelAlignment
135 Specifies justification of text within the child's associated
136 label. Valid values are the same as those for XmNdefault‐
137 EntryLabelAlignment.
138 mNentryLabelFontList
140 Specifies fontList used to render the text within the child's
141 associated label.
142 XmNentryLabelPixmap
144 Specifies the pixmap used in the child's associated label.
145 XmNentryLabelString
147 Specifies the text used in the child's associated label.
148 XmNentryLabelType
150 Specifies whether to display a string (XmSTRING) or a pixmap
151 (XmPIXMAP) in the child's associated label.
152 XmNfillStyle
154 Specifies whether the child should be displayed at its natu‐
155 ral size (XmFILL_RAGGED) or stretched to fill the entire
156 width of the column it is displayed within (XmFILL_FLUSH).
157 XmFILL_UNSPECIFIED uses the value of the XmColumn's XmNde‐
158 faultFillStyle.
159 XmNshowEntryLabel
161 Specifies whether or not to display the child's associated
162 label.
163 XmNstretchable
165 Specifies whether the child should expand in size proportion‐
166 ately when the XmColumn is resized vertically to be larger
167 than its natural size.
168
170 Composite(3), Core(3), XmBulletinBoard(3), XmCreateColumn(3), XmMan‐
171 ager(3), XmVaCreateColumn(3), and XmVaCreateManagedColumn(3).
172
174 This manual page documents the XmColumn widget shipped in Motif version
175 2.2
176 XmColumn(library call)