1XmForm(library call) XmForm(library call)
2
3
4
6 XmForm — The Form widget class
7
9 #include <Xm/Form.h>
10
12 Form is a container widget with no input semantics of its own. Con‐
13 straints are placed on children of the Form to define attachments for
14 each of the child's four sides. These attachments can be to the Form,
15 to another child widget or gadget, to a relative position within the
16 Form, or to the initial position of the child. The attachments deter‐
17 mine the layout behavior of the Form when resizing occurs.
18
19 The default value for XmNinitialFocus is the value of XmNdefaultButton.
20
21 Following are some important considerations in using a Form:
22
23 · Every child must have an attachment on either the left or the
24 right. If initialization or XtSetValues leaves a widget without
25 such an attachment, the result depends upon the value of XmNrub‐
26 berPositioning.
27
28 If XmNrubberPositioning is False, the child is given an XmN‐
29 leftAttachment of XmATTACH_FORM and an XmNleftOffset equal to
30 its current x value.
31
32 If XmNrubberPositioning is True, the child is given an XmN‐
33 leftAttachment of XmATTACH_POSITION and an XmNleftPosition
34 proportional to the current x value divided by the width of
35 the Form.
36
37 In either case, if the child has not been previously given an
38 x value, its x value is taken to be 0 (zero), which places
39 the child at the left side of the Form.
40
41 · If you want to create a child without any attachments, and then
42 later (for example, after creating and managing it, but before
43 realizing it) give it a right attachment through XtSetValues, you
44 must set its XmNleftAttachment to XmATTACH_NONE at the same time.
45
46 · The XmNresizable resource controls only whether a geometry
47 request by the child will be granted. It has no effect on
48 whether the child's size can be changed because of changes in
49 geometry of the Form or of other children.
50
51 · Every child has a preferred width, based on geometry requests it
52 makes (whether they are granted or not).
53
54 · If a child has attachments on both the left and the right sides,
55 its size is completely controlled by the Form. It can be shrunk
56 below its preferred width or enlarged above it, if necessary, due
57 to other constraints. In addition, the child's geometry requests
58 to change its own width may be refused.
59
60 · If a child has attachments on only its left or right side, it
61 will always be at its preferred width (if resizable, otherwise at
62 is current width). This may cause it to be clipped by the Form
63 or by other children.
64
65 · If a child's left (or right) attachment is set to XmATTACH_SELF,
66 its corresponding left (or right) offset is forced to 0 (zero).
67 The attachment is then changed to XmATTACH_POSITION, with a posi‐
68 tion that corresponds to the x value of the child's left (or
69 right) edge. To fix the position of a side at a specific x
70 value, use XmATTACH_FORM or XmATTACH_OPPOSITE_FORM with the x
71 value as the left (or right) offset.
72
73 · Unmapping a child has no effect on the Form except that the child
74 is not mapped.
75
76 · Unmanaging a child unmaps it. If no other child is attached to
77 it, or if all children attached to it and all children recur‐
78 sively attached to them are also all unmanaged, all of those
79 children are treated as if they did not exist in determining the
80 size of the Form.
81
82 · When using XtSetValues to change the XmNx resource of a child,
83 you must simultaneously set its left attachment to either XmAT‐
84 TACH_SELF or XmATTACH_NONE. Otherwise, the request is not
85 granted. If XmNresizable is False, the request is granted only
86 if the child's size can remain the same.
87
88 · A left (or right) attachment of XmATTACH_WIDGET, where XmNleft‐
89 Widget (or XmNrightWidget) is NULL, acts like an attachment of
90 XmATTACH_FORM.
91
92 · If an attachment is made to a widget that is not a child of the
93 Form, but an ancestor of the widget is a child of the Form, the
94 attachment is made to the ancestor.
95
96 All these considerations are true of top and bottom attachments as
97 well, with top acting like left, bottom acting like right, y acting
98 like x, and height acting like width.
99
100 Classes
101 Form inherits behavior, resources, and traits from Core, Composite,
102 Constraint, XmManager, and XmBulletinBoard.
103
104 The class pointer is xmFormWidgetClass.
105
106 The class name is XmForm.
107
108 New Resources
109 The following table defines a set of widget resources used by the pro‐
110 grammer to specify data. The programmer can also set the resource val‐
111 ues for the inherited classes to set attributes for this widget. To
112 reference a resource by name or by class in a .Xdefaults file, remove
113 the XmN or XmC prefix and use the remaining letters. To specify one of
114 the defined values for a resource in a .Xdefaults file, remove the Xm
115 prefix and use the remaining letters (in either lowercase or uppercase,
116 but include any underscores between words). The codes in the access
117 column indicate if the given resource can be set at creation time (C),
118 set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
119 not applicable (N/A).
120
121 ┌───────────────────────────────────────────────────────────────────────────┐
122 │ │ XmForm Resource S│et │ │ │
123 │Name │ Class │ Type │ Default │ Access │
124 ├─────────────────────┼──────────────────────┼───────────┼─────────┼────────┤
125 │XmNfractionBase │ XmCMaxValue │ int │ 100 │ CSG │
126 ├─────────────────────┼──────────────────────┼───────────┼─────────┼────────┤
127 │XmNhorizontalSpacing │ XmCSpacing │ Dimension │ 0 │ CSG │
128 ├─────────────────────┼──────────────────────┼───────────┼─────────┼────────┤
129 │XmNrubberPositioning │ XmCRubberPositioning │ Boolean │ False │ CSG │
130 ├─────────────────────┼──────────────────────┼───────────┼─────────┼────────┤
131 │XmNverticalSpacing │ XmCSpacing │ Dimension │ 0 │ CSG │
132 ├─────────────────────┼──────────────────────┼───────────┼─────────┼────────┤
133 └─────────────────────┴──────────────────────┴───────────┴─────────┴────────┘
134 XmNfractionBase
135 Specifies the denominator used in calculating the relative
136 position of a child widget using XmATTACH_POSITION con‐
137 straints. The value must not be 0 (zero).
138
139 If the value of a child's XmNleftAttachment (or XmNrightAt‐
140 tachment) is XmATTACH_POSITION, the position of the left (or
141 right) side of the child is relative to the left side of the
142 Form and is a fraction of the width of the Form. This frac‐
143 tion is the value of the child's XmNleftPosition (or XmN‐
144 rightPosition) resource divided by the value of the Form's
145 XmNfractionBase.
146
147 If the value of a child's XmNtopAttachment (or XmNbottomAt‐
148 tachment) is XmATTACH_POSITION, the position of the top (or
149 bottom) side of the child is relative to the top side of the
150 Form and is a fraction of the height of the Form. This frac‐
151 tion is the value of the child's XmNtopPosition (or XmNbot‐
152 tomPosition) resource divided by the value of the Form's XmN‐
153 fractionBase.
154
155 XmNhorizontalSpacing
156 Specifies the offset for right and left attachments. This
157 resource is only used if no offset resource is specified
158 (when attaching to a widget), or if no margin resource is
159 specified (when attaching to the Form).
160
161 XmNrubberPositioning
162 Indicates the default near (left) and top attachments for a
163 child of the Form. (Note that whether this resource actually
164 applies to the left or right side of the child and its
165 attachment depends on the value of the XmNlayoutDirection.)
166
167 The default left attachment is applied whenever initializa‐
168 tion or XtSetValues leaves the child without either a left or
169 right attachment. The default top attachment is applied
170 whenever initialization or XtSetValues leaves the child with‐
171 out either a top or bottom attachment.
172
173 If this Boolean resource is set to False, XmNleftAttachment
174 and XmNtopAttachment default to XmATTACH_FORM, XmNleftOffset
175 defaults to the current x value of the left side of the
176 child, and XmNtopOffset defaults to the current y value of
177 the child. The effect is to position the child according to
178 its absolute distance from the left or top side of the Form.
179
180 If this resource is set to True, XmNleftAttachment and XmN‐
181 topAttachment default to XmATTACH_POSITION, XmNleftPosition
182 defaults to a value proportional to the current x value of
183 the left side of the child divided by the width of the Form,
184 and XmNtopPosition defaults to a value proportional to the
185 current y value of the child divided by the height of the
186 Form. The effect is to position the child relative to the
187 left or top side of the Form and in proportion to the width
188 or height of the Form.
189
190 XmNverticalSpacing
191 Specifies the offset for top and bottom attachments. This
192 resource is only used if no offset resource is specified
193 (when attaching to a widget), or if no margin resource is
194 specified (when attaching to the Form).
195
196
197
198 ┌─────────────────────────────────────────────────────────────────────────────┐
199 │ │ XmForm Constr│aint Resource Se│t │ │
200 │Name │ Class │ Type │ Default │ Access │
201 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
202 │XmNbottomAttachment │ XmCAttachment │ unsigned char │ XmATTACH_NONE │ CSG │
203 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
204 │XmNbottomOffset │ XmCOffset │ int │ 0 │ CSG │
205 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
206 │XmNbottomPosition │ XmCPosition │ int │ 0 │ CSG │
207 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
208 │XmNbottomWidget │ XmCWidget │ Widget │ NULL │ CSG │
209 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
210 │XmNleftAttachment │ XmCAttachment │ unsigned char │ XmATTACH_NONE │ CSG │
211 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
212 │XmNleftOffset │ XmCOffset │ int │ 0 │ CSG │
213 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
214 │XmNleftPosition │ XmCPosition │ int │ 0 │ CSG │
215 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
216 │XmNleftWidget │ XmCWidget │ Widget │ NULL │ CSG │
217 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
218 │XmNresizable │ XmCBoolean │ Boolean │ True │ CSG │
219 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
220 │XmNrightAttachment │ XmCAttachment │ unsigned char │ XmATTACH_NONE │ CSG │
221 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
222 │XmNrightOffset │ XmCOffset │ int │ 0 │ CSG │
223 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
224 │XmNrightPosition │ XmCPosition │ int │ 0 │ CSG │
225 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
226 │XmNrightWidget │ XmCWidget │ Widget │ NULL │ CSG │
227 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
228 │XmNtopAttachment │ XmCAttachment │ unsigned char │ XmATTACH_NONE │ CSG │
229 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
230 │XmNtopOffset │ XmCOffset │ int │ 0 │ CSG │
231 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
232 │XmNtopPosition │ XmCPosition │ int │ 0 │ CSG │
233 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
234 │XmNtopWidget │ XmCWidget │ Widget │ NULL │ CSG │
235 ├────────────────────┼───────────────┼───────────────┼───────────────┼────────┤
236 └────────────────────┴───────────────┴───────────────┴───────────────┴────────┘
237 XmNbottomAttachment
238 Specifies attachment of the bottom side of the child. It can
239 have the following values:
240
241 XmATTACH_NONE
242 Do not attach the bottom side of the child.
243
244 XmATTACH_FORM
245 Attach the bottom side of the child to the bottom
246 side of the Form.
247
248 XmATTACH_OPPOSITE_FORM
249 Attach the bottom side of the child to the top side
250 of the Form. XmNbottomOffset can be used to deter‐
251 mine the visibility of the child.
252
253 XmATTACH_WIDGET
254 Attach the bottom side of the child to the top side
255 of the widget or gadget specified in the XmNbot‐
256 tomWidget resource. If XmNbottomWidget is NULL,
257 XmATTACH_WIDGET is replaced by XmATTACH_FORM, and
258 the child is attached to the bottom side of the
259 Form.
260
261 XmATTACH_OPPOSITE_WIDGET
262 Attach the bottom side of the child to the bottom
263 side of the widget or gadget specified in the XmN‐
264 bottomWidget resource.
265
266 XmATTACH_POSITION
267 Attach the bottom side of the child to a position
268 that is relative to the top side of the Form and in
269 proportion to the height of the Form. This posi‐
270 tion is determined by the XmNbottomPosition and
271 XmNfractionBase resources.
272
273 XmATTACH_SELF
274 Attach the bottom side of the child to a position
275 that is proportional to the current y value of the
276 bottom of the child divided by the height of the
277 Form. This position is determined by the XmNbot‐
278 tomPosition and XmNfractionBase resources. XmNbot‐
279 tomPosition is set to a value proportional to the
280 current y value of the bottom of the child divided
281 by the height of the Form.
282
283 XmNbottomOffset
284 Specifies the constant offset between the bottom side of the
285 child and the object to which it is attached. The relation‐
286 ship established remains, regardless of any resizing opera‐
287 tions that occur. When this resource is explicitly set, the
288 value of XmNverticalSpacing is ignored.
289
290 XmNbottomPosition
291 This resource is used to determine the position of the bottom
292 side of the child when the child's XmNbottomAttachment is set
293 to XmATTACH_POSITION. In this case the position of the bot‐
294 tom side of the child is relative to the top side of the Form
295 and is a fraction of the height of the Form. This fraction
296 is the value of the child's XmNbottomPosition resource
297 divided by the value of the Form's XmNfractionBase. For
298 example, if the child's XmNbottomPosition is 50, the Form's
299 XmNfractionBase is 100, and the Form's height is 200, the
300 position of the bottom side of the child is 100.
301
302 XmNbottomWidget
303 Specifies the widget or gadget to which the bottom side of
304 the child is attached. This resource is used if the XmNbot‐
305 tomAttachment resource is set to either XmATTACH_WIDGET or
306 XmATTACH_OPPOSITE_WIDGET.
307
308 A string-to-widget resource converter is automatically
309 installed for use with this resource. With this converter,
310 the widget that is to be the value of the resource must exist
311 at the time the widget that has the resource is created.
312
313 XmNleftAttachment
314 Specifies attachment of the near (left) side of the child.
315 (Note that whether this resource actually applies to the left
316 or right side of the child and its attachment depends on the
317 value of the XmNlayoutDirection resource.) It can have the
318 following values:
319
320 XmATTACH_NONE
321 Do not attach the left side of the child. If XmN‐
322 rightAttachment is also XmATTACH_NONE, this value
323 is ignored and the child is given a default left
324 attachment.
325
326 XmATTACH_FORM
327 Attach the left side of the child to the left side
328 of the Form.
329
330 XmATTACH_OPPOSITE_FORM
331 Attach the left side of the child to the right side
332 of the Form. XmNleftOffset can be used to deter‐
333 mine the visibility of the child.
334
335 XmATTACH_WIDGET
336 Attach the left side of the child to the right side
337 of the widget or gadget specified in the XmNleft‐
338 Widget resource. If XmNleftWidget is NULL, XmAT‐
339 TACH_WIDGET is replaced by XmATTACH_FORM, and the
340 child is attached to the left side of the Form.
341
342 XmATTACH_OPPOSITE_WIDGET
343 Attach the left side of the child to the left side
344 of the widget or gadget specified in the XmNleft‐
345 Widget resource.
346
347 XmATTACH_POSITION
348 Attach the left side of the child to a position
349 that is relative to the left side of the Form and
350 in proportion to the width of the Form. This posi‐
351 tion is determined by the XmNleftPosition and XmN‐
352 fractionBase resources.
353
354 XmATTACH_SELF
355 Attach the left side of the child to a position
356 that is proportional to the current x value of the
357 left side of the child divided by the width of the
358 Form. This position is determined by the XmNleft‐
359 Position and XmNfractionBase resources. XmNleftPo‐
360 sition is set to a value proportional to the cur‐
361 rent x value of the left side of the child divided
362 by the width of the Form.
363
364 XmNleftOffset
365 Specifies the constant offset between the near (left) side of
366 the child and the object to which it is attached. (Note that
367 whether this resource actually applies to the left or right
368 side of the child and its attachment depends on the value of
369 the XmNlayoutDirection resource.) The relationship estab‐
370 lished remains, regardless of any resizing operations that
371 occur. When this resource is explicitly set, the value of
372 XmNhorizontalSpacing is ignored.
373
374 XmNleftPosition
375 This resource is used to determine the position of the near
376 (left) side of the child when the child's XmNleftAttachment
377 is set to XmATTACH_POSITION. (Note that whether this
378 resource actually applies to the left or right side of the
379 child and its attachment depends on the value of the XmNlay‐
380 outDirection resource.)
381
382 In this case, the position of the left side of the child is
383 relative to the left side of the Form and is a fraction of
384 the width of the Form. This fraction is the value of the
385 child's XmNleftPosition resource divided by the value of the
386 Form's XmNfractionBase. For example, if the child's XmNleft‐
387 Position is 50, the Form's XmNfractionBase is 100, and the
388 Form's width is 200, the position of the left side of the
389 child is 100.
390
391 XmNleftWidget
392 Specifies the widget or gadget to which the near (left) side
393 of the child is attached. (Note that whether this resource
394 actually applies to the left or right side of the child and
395 its attachment depends on the value of the XmNlayoutDirection
396 resource.) The XmNleftWidget resource is used if the XmNlef‐
397 tAttachment resource is set to either XmATTACH_WIDGET or
398 XmATTACH_OPPOSITE_WIDGET.
399
400 A string-to-widget resource converter is automatically
401 installed for use with this resource. With this converter,
402 the widget that is to be the value of the resource must exist
403 at the time the widget that has the resource is created.
404
405 XmNresizable
406 This Boolean resource specifies whether or not a child's
407 request for a new size is (conditionally) granted by the
408 Form. If this resource is set to True the request is granted
409 if possible. If this resource is set to False the request is
410 always refused.
411
412 If a child has both left and right attachments, its width is
413 completely controlled by the Form, regardless of the value of
414 the child's XmNresizable resource. If a child has a left or
415 right attachment but not both, the child's XmNwidth is used
416 in setting its width if the value of the child's XmNresizable
417 resource is True. These conditions are also true for top and
418 bottom attachments, with height acting like width.
419
420 XmNrightAttachment
421 Specifies attachment of the far (right) side of the child.
422 (Note that whether this resource actually applies to the left
423 or right side of the child and its attachment depends on the
424 value of the XmNlayoutDirection resource.) It can have the
425 following values:
426
427 XmATTACH_NONE
428 Do not attach the right side of the child.
429
430 XmATTACH_FORM
431 Attach the right side of the child to the right
432 side of the Form.
433
434 XmATTACH_OPPOSITE_FORM
435 Attach the right side of the child to the left side
436 of the Form. XmNrightOffset can be used to deter‐
437 mine the visibility of the child.
438
439 XmATTACH_WIDGET
440 Attach the right side of the child to the left side
441 of the widget or gadget specified in the XmN‐
442 rightWidget resource. If XmNrightWidget is NULL,
443 XmATTACH_WIDGET is replaced by XmATTACH_FORM, and
444 the child is attached to the right side of the
445 Form.
446
447 XmATTACH_OPPOSITE_WIDGET
448 Attach the right side of the child to the right
449 side of the widget or gadget specified in the XmN‐
450 rightWidget resource.
451
452 XmATTACH_POSITION
453 Attach the right side of the child to a position
454 that is relative to the left side of the Form and
455 in proportion to the width of the Form. This posi‐
456 tion is determined by the XmNrightPosition and XmN‐
457 fractionBase resources.
458
459 XmATTACH_SELF
460 Attach the right side of the child to a position
461 that is proportional to the current x value of the
462 right side of the child divided by the width of the
463 Form. This position is determined by the XmNright‐
464 Position and XmNfractionBase resources. XmNright‐
465 Position is set to a value proportional to the cur‐
466 rent x value of the right side of the child divided
467 by the width of the Form.
468
469 XmNrightOffset
470 Specifies the constant offset between the far (right) side of
471 the child and the object to which it is attached. (Note that
472 whether this resource actually applies to the left or right
473 side of the child and its attachment depends on the value of
474 the XmNlayoutDirection resource.) The relationship estab‐
475 lished remains, regardless of any resizing operations that
476 occur. When this resource is explicitly set, the value of
477 XmNhorizontalSpacing is ignored.
478
479 XmNrightPosition
480 This resource is used to determine the position of the far
481 (right) side of the child when the child's XmNrightAttachment
482 is set to XmATTACH_POSITION. (Note that whether this
483 resource actually applies to the left or right side of the
484 child and its attachment depends on the value of the XmNlay‐
485 outDirection resource.)
486
487 In this case the position of the right side of the child is
488 relative to the left side of the Form and is a fraction of
489 the width of the Form. This fraction is the value of the
490 child's XmNrightPosition resource divided by the value of the
491 Form's XmNfractionBase. For example, if the child's XmN‐
492 rightPosition is 50, the Form's XmNfractionBase is 100, and
493 the Form's width is 200, the position of the right side of
494 the child is 100.
495
496 XmNrightWidget
497 Specifies the widget or gadget to which the far (right) side
498 of the child is attached. (Note that whether this resource
499 actually applies to the left or right side of the child and
500 its attachment depends on the value of the XmNlayoutDirection
501 resource.) The XmNrightWidget resource is used if the XmN‐
502 rightAttachment resource is set to either XmATTACH_WIDGET or
503 XmATTACH_OPPOSITE_WIDGET.
504
505 A string-to-widget resource converter is automatically
506 installed for use with this resource. With this converter,
507 the widget that is to be the value of the resource must exist
508 at the time the widget that has the resource is created.
509
510 XmNtopAttachment
511 Specifies attachment of the top side of the child. It can
512 have following values:
513
514 XmATTACH_NONE
515 Do not attach the top side of the child. If the
516 XmNbottomAttachment resource is also XmATTACH_NONE,
517 this value is ignored and the child is given a
518 default top attachment.
519
520 XmATTACH_FORM
521 Attach the top side of the child to the top side of
522 the Form.
523
524 XmATTACH_OPPOSITE_FORM
525 Attach the top side of the child to the bottom side
526 of the Form. XmNtopOffset can be used to determine
527 the visibility of the child.
528
529 XmATTACH_WIDGET
530 Attach the top side of the child to the bottom side
531 of the widget or gadget specified in the XmNtopWid‐
532 get resource. If XmNtopWidget is NULL, XmAT‐
533 TACH_WIDGET is replaced by XmATTACH_FORM and the
534 child is attached to the top side of the Form.
535
536 XmATTACH_OPPOSITE_WIDGET
537 Attach the top side of the child to the top side of
538 the widget or gadget specified in the XmNtopWidget
539 resource.
540
541 XmATTACH_POSITION
542 Attach the top side of the child to a position that
543 is relative to the top side of the Form and in pro‐
544 portion to the height of the Form. This position
545 is determined by the XmNtopPosition and XmNfrac‐
546 tionBase resources.
547
548 XmATTACH_SELF
549 Attach the top side of the child to a position that
550 is proportional to the current y value of the child
551 divided by the height of the Form. This position
552 is determined by the XmNtopPosition and XmNfrac‐
553 tionBase resources. XmNtopPosition is set to a
554 value proportional to the current y value of the
555 child divided by the height of the Form.
556
557 XmNtopOffset
558 Specifies the constant offset between the top side of the
559 child and the object to which it is attached. The relation‐
560 ship established remains, regardless of any resizing opera‐
561 tions that occur. When this resource is explicitly set, the
562 value of XmNverticalSpacing is ignored.
563
564 XmNtopPosition
565 This resource is used to determine the position of the top
566 side of the child when the child's XmNtopAttachment is set to
567 XmATTACH_POSITION. In this case, the position of the top
568 side of the child is relative to the top side of the Form and
569 is a fraction of the height of the Form. This fraction is
570 the value of the child's XmNtopPosition resource divided by
571 the value of the Form's XmNfractionBase. For example, if the
572 child's XmNtopPosition is 50, the Form's XmNfractionBase is
573 100, and the Form's height is 200, the position of the top
574 side of the child is 100.
575
576 XmNtopWidget
577 Specifies the widget or gadget to which the top side of the
578 child is attached. This resource is used if XmNtopAttachment
579 is set to a value of either XmATTACH_WIDGET or XmATTACH_OPPO‐
580 SITE_WIDGET.
581
582 A string-to-widget resource converter is automatically
583 installed for use with this resource. With this converter,
584 the widget that is to be the value of the resource must exist
585 at the time the widget that has the resource is created.
586
587 Inherited Resources
588 Form inherits behavior and resources from the superclasses described in
589 the following tables. For a complete description of each resource,
590 refer to the reference page for that superclass.
591
592 ┌─────────────────────────────────────────────────────────────────────────────────────┐
593 │ │ XmBulletinBoard │Resource Set │ │ │
594 │Name │ Class │ Type │ Default │ Access │
595 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
596 │XmNallowOverlap │ XmCAllowOverlap │ Boolean │ True │ CSG │
597 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
598 │XmNautoUnmanage │ XmCAutoUnmanage │ Boolean │ True │ CG │
599 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
600 │XmNbuttonFontList │ XmCButtonFontList │ XmFontList │ dynamic │ CSG │
601 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
602 │XmNbuttonRenderTable │ XmCButtonRenderTable │ XmRenderTable │ dynamic │ CSG │
603 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
604 │XmNcancelButton │ XmCWidget │ Widget │ NULL │ SG │
605 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
606 │XmNdefaultButton │ XmCWidget │ Widget │ NULL │ SG │
607 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
608 │XmNdefaultPosition │ XmCDefaultPosition │ Boolean │ True │ CSG │
609 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
610 │XmNdialogStyle │ XmCDialogStyle │ unsigned char │ dynamic │ CSG │
611 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
612 │XmNdialogTitle │ XmCDialogTitle │ XmString │ NULL │ CSG │
613 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
614 │XmNfocusCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
615 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
616 │XmNlabelFontList │ XmCLabelFontList │ XmFontList │ dynamic │ CSG │
617 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
618 │XmNlabelRenderTable │ XmCLabelRenderTable │ XmRenderTable │ dynamic │ CSG │
619 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
620 │XmNmapCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
621 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
622 │XmNmarginHeight │ XmCMarginHeight │ Dimension │ 0 │ CSG │
623 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
624 │XmNmarginWidth │ XmCMarginWidth │ Dimension │ 0 │ CSG │
625 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
626 │XmNnoResize │ XmCNoResize │ Boolean │ False │ CSG │
627 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
628 │XmNresizePolicy │ XmCResizePolicy │ unsigned char │ XmRESIZE_ANY │ CSG │
629 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
630 │XmNshadowType │ XmCShadowType │ unsigned char │ XmSHADOW_OUT │ CSG │
631 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
632 │XmNtextFontList │ XmCTextFontList │ XmFontList │ dynamic │ CSG │
633 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
634 │XmNtextRenderTable │ XmCTextRenderTable │ XmRenderTable │ dynamic │ CSG │
635 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
636 │XmNtextTranslations │ XmCTranslations │ XtTranslations │ NULL │ C │
637 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
638 │XmNunmapCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
639 ├─────────────────────┼──────────────────────┼────────────────┼──────────────┼────────┤
640 └─────────────────────┴──────────────────────┴────────────────┴──────────────┴────────┘
641 ┌────────────────────────────────────────────────────────────────────────────────────────────────────┐
642 │ │ XmManager │Resource Set │ │ │
643 │Name │ Class │ Type │ Default │ Access │
644 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
645 │XmNbottomShadowColor │ XmCBottomShadowColor │ Pixel │ dynamic │ CSG │
646 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
647 │XmNbottomShadowPixmap │ XmCBottomShadowPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
648 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
649 │XmNforeground │ XmCForeground │ Pixel │ dynamic │ CSG │
650 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
651 │XmNhelpCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
652 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
653 │XmNhighlightColor │ XmCHighlightColor │ Pixel │ dynamic │ CSG │
654 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
655 │XmNhighlightPixmap │ XmCHighlightPixmap │ Pixmap │ dynamic │ CSG │
656 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
657 │XmNinitialFocus │ XmCInitialFocus │ Widget │ dynamic │ CSG │
658 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
659 │XmNlayoutDirection │ XmCLayoutDirection │ XmDirection │ dynamic │ CG │
660 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
661 │XmNnavigationType │ XmCNavigationType │ XmNavigationType │ XmTAB_GROUP │ CSG │
662 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
663 │XmNpopupHandlerCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
664 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
665 │XmNshadowThickness │ XmCShadowThickness │ Dimension │ dynamic │ CSG │
666 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
667 │XmNstringDirection │ XmCStringDirection │ XmStringDirection │ dynamic │ CG │
668 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
669 │XmNtopShadowColor │ XmCTopShadowColor │ Pixel │ dynamic │ CSG │
670 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
671 │XmNtopShadowPixmap │ XmCTopShadowPixmap │ Pixmap │ dynamic │ CSG │
672 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
673 │XmNtraversalOn │ XmCTraversalOn │ Boolean │ True │ CSG │
674 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
675 │XmNunitType │ XmCUnitType │ unsigned char │ dynamic │ CSG │
676 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
677 │XmNuserData │ XmCUserData │ XtPointer │ NULL │ CSG │
678 ├────────────────────────┼───────────────────────┼───────────────────┼──────────────────────┼────────┤
679 └────────────────────────┴───────────────────────┴───────────────────┴──────────────────────┴────────┘
680 ┌───────────────────────────────────────────────────────────────────────┐
681 │ │ Composite Reso│urce Set │ │ │
682 │Name │ Class │ Type │ Default │ Access │
683 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
684 │XmNchildren │ XmCReadOnly │ WidgetList │ NULL │ G │
685 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
686 │XmNinsertPosition │ XmCInsertPosition │ XtOrderProc │ NULL │ CSG │
687 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
688 │XmNnumChildren │ XmCReadOnly │ Cardinal │ 0 │ G │
689 ├──────────────────┼───────────────────┼─────────────┼─────────┼────────┤
690 └──────────────────┴───────────────────┴─────────────┴─────────┴────────┘
691 ┌───────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
692 │ │ Core Resource Se│t │ │ │
693 │Name │ Class │ Type │ Default │ Access │
694 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
695 │XmNaccelerators │ XmCAccelerators │ XtAccelerators │ dynamic │ N/A │
696 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
697 │XmNancestorSensitive │ XmCSensitive │ Boolean │ dynamic │ G │
698 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
699 │XmNbackground │ XmCBackground │ Pixel │ dynamic │ CSG │
700 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
701 │XmNbackgroundPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
702 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
703 │XmNborderColor │ XmCBorderColor │ Pixel │ XtDefaultForeground │ CSG │
704 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
705 │XmNborderPixmap │ XmCPixmap │ Pixmap │ XmUNSPECIFIED_PIXMAP │ CSG │
706 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
707 │XmNborderWidth │ XmCBorderWidth │ Dimension │ 0 │ CSG │
708 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
709 │XmNcolormap │ XmCColormap │ Colormap │ dynamic │ CG │
710 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
711 │XmNdepth │ XmCDepth │ int │ dynamic │ CG │
712 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
713 │XmNdestroyCallback │ XmCCallback │ XtCallbackList │ NULL │ C │
714 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
715 │XmNheight │ XmCHeight │ Dimension │ dynamic │ CSG │
716 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
717 │XmNinitialResourcesPersistent │ XmCInitialResourcesPersistent │ Boolean │ True │ C │
718 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
719 │XmNmappedWhenManaged │ XmCMappedWhenManaged │ Boolean │ True │ CSG │
720 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
721 │XmNscreen │ XmCScreen │ Screen * │ dynamic │ CG │
722 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
723 │XmNsensitive │ XmCSensitive │ Boolean │ True │ CSG │
724 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
725 │XmNtranslations │ XmCTranslations │ XtTranslations │ dynamic │ CSG │
726 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
727 │XmNwidth │ XmCWidth │ Dimension │ dynamic │ CSG │
728 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
729 │XmNx │ XmCPosition │ Position │ 0 │ CSG │
730 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
731 │XmNy │ XmCPosition │ Position │ 0 │ CSG │
732 ├──────────────────────────────┼───────────────────────────────┼────────────────┼──────────────────────┼────────┤
733 └──────────────────────────────┴───────────────────────────────┴────────────────┴──────────────────────┴────────┘
734 Translations
735 XmForm inherits translations from XmBulletinBoard.
736
738 Composite(3), Constraint(3), Core(3), XmBulletinBoard(3), XmCreateForm,
739 XmCreateFormDialog(3), XmManager(3), XmVaCreateForm, and XmVaCreateMan‐
740 agedForm.
741
742
743
744 XmForm(library call)