1XmColumn(library call)                                  XmColumn(library call)
2
3
4

NAME

6       XmColumn — The XmColumn widget class
7

SYNOPSIS

9       #include <Xm/Column.h>
10

DESCRIPTION

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

Classes

23       XmColumn  inherits  behavior  and  resources from Core, Composite, Con‐
24       straint, XmManager, and XmBulletinBoard.
25
26       The class pointer is xmColumnWidgetClass.
27
28       The class name is XmColumn.
29
30   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
40       ┌───────────────────────────────────────────────────────────────────────────────────────────────────┐
41       │                                │     XmColumn Res│ource Set       │                       │        │
42Name                            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
71       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
76       XmNdefaultFillStyle
77                 Specifies the default XmNfillStyle to use when a child speci‐
78                 fies no significant value.
79
80       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
89       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
94       XmNlabelSpacing
95                 Specifies  the  spacing  between  the  column  containing the
96                 labels and the column containing the XmColumn's children.
97
98       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
104
105
106       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
111       ┌───────────────────────────────────────────────────────────────────────────────────────────────┐
112       │                         │     XmColumn Co│nstraint Resourc│e Set                     │          │
113Name                     Class          Type          Default                 AccessfP 
114       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
115XmNentryLabelAlignment   XmCAlignment   unsigned char XmALIGNMENT_UNSPECIFIED CSG      
116       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
117XmNentryLabelFontList    XmCFontList    XmFontList    dynamic                 CSG      
118       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
119XmNentryLabelRenderTable XmCRenderTable XmRenderTable dynamic                 CSG      
120       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
121XmNentryLabelPixmap      XmCLabelPixmap Pixmap        XmUNPECIFIED_PIXMAP     CSG      
122       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
123XmNentryLabelString      XmCLabelString XmString      NULL                    CSG      
124       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
125XmNentryLabelType        XmCLabelType   unsigned char XmSTRING                CSG      
126       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
127XmNfillStyle             XmCFillStyle   unsigned char XmFILL_UNSPECIFIED      CSG      
128       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
129XmNshowEntryLabel        XmCShowLabel   Boolean       True                    CSG      
130       ├─────────────────────────┼────────────────┼───────────────┼─────────────────────────┼──────────┤
131XmNstretchable           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
139       mNentryLabelFontList
140                 Specifies fontList used to render the text within the child's
141                 associated label.
142
143       XmNentryLabelPixmap
144                 Specifies the pixmap used in the child's associated label.
145
146       XmNentryLabelString
147                 Specifies the text used in the child's associated label.
148
149       XmNentryLabelType
150                 Specifies  whether to display a string (XmSTRING) or a pixmap
151                 (XmPIXMAP) in the child's associated label.
152
153       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
160       XmNshowEntryLabel
161                 Specifies  whether  or  not to display the child's associated
162                 label.
163
164       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

VERSION

174       This manual page documents the XmColumn widget shipped in Motif version
175       2.2
176
177                                                        XmColumn(library call)
Impressum