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

NAME

6       XmForm — The Form widget class
7

SYNOPSIS

9       #include <Xm/Form.h>
10

DESCRIPTION

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          │         │        │
123Name                 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               │        │
200Name                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     │              │        │
594Name                 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        │                      │        │
643Name                    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      │         │        │
682Name              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                │                      │        │
693Name                          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)
Impressum