manpagez: man pages & more
man XmForm(3)
Home | html | info | man
XmForm(library call)                                      XmForm(library call)




NAME

       XmForm -- The Form widget class


SYNOPSIS

       #include <Xm/Form.h>


DESCRIPTION

       Form  is  a  container widget with no input semantics of its own.  Con-
       straints are placed on children of the Form to define  attachments  for
       each  of the child's four sides.  These attachments can be to the Form,
       to another child widget or gadget, to a relative  position  within  the
       Form,  or to the initial position of the child.  The attachments deter-
       mine the layout behavior of the Form when resizing occurs.

       The default value for XmNinitialFocus is the value of XmNdefaultButton.

       Following are some important considerations in using a Form:

          o  Every  child  must  have  an attachment on either the left or the
             right.  If initialization or XtSetValues leaves a widget  without
             such  an attachment, the result depends upon the value of XmNrub-
             berPositioning.

                 If XmNrubberPositioning is False, the child is given an  XmN-
                 leftAttachment of XmATTACH_FORM and an XmNleftOffset equal to
                 its current x value.

                 If XmNrubberPositioning is True, the child is given  an  XmN-
                 leftAttachment  of  XmATTACH_POSITION  and an XmNleftPosition
                 proportional to the current x value divided by the  width  of
                 the Form.

                 In either case, if the child has not been previously given an
                 x value, its x value is taken to be 0  (zero),  which  places
                 the child at the left side of the Form.

          o  If  you  want to create a child without any attachments, and then
             later (for example, after creating and managing  it,  but  before
             realizing it) give it a right attachment through XtSetValues, you
             must set its XmNleftAttachment to XmATTACH_NONE at the same time.

          o  The  XmNresizable  resource  controls  only  whether  a  geometry
             request by the child will  be  granted.   It  has  no  effect  on
             whether  the  child's  size  can be changed because of changes in
             geometry of the Form or of other children.

          o  Every child has a preferred width, based on geometry requests  it
             makes (whether they are granted or not).

          o  If  a child has attachments on both the left and the right sides,
             its size is completely controlled by the Form.  It can be  shrunk
             below its preferred width or enlarged above it, if necessary, due
             to other constraints.  In addition, the child's geometry requests
             to change its own width may be refused.

          o  If  a  child  has  attachments on only its left or right side, it
             will always be at its preferred width (if resizable, otherwise at
             is  current  width).  This may cause it to be clipped by the Form
             or by other children.

          o  If a child's left (or right) attachment is set to  XmATTACH_SELF,
             its  corresponding  left (or right) offset is forced to 0 (zero).
             The attachment is then changed to XmATTACH_POSITION, with a posi-
             tion  that  corresponds  to  the  x value of the child's left (or
             right) edge.  To fix the position of  a  side  at  a  specific  x
             value,  use  XmATTACH_FORM  or  XmATTACH_OPPOSITE_FORM with the x
             value as the left (or right) offset.

          o  Unmapping a child has no effect on the Form except that the child
             is not mapped.

          o  Unmanaging  a  child unmaps it.  If no other child is attached to
             it, or if all children attached to it  and  all  children  recur-
             sively  attached  to  them  are  also all unmanaged, all of those
             children are treated as if they did not exist in determining  the
             size of the Form.

          o  When  using  XtSetValues  to change the XmNx resource of a child,
             you must simultaneously set its left attachment to  either  XmAT-
             TACH_SELF  or  XmATTACH_NONE.   Otherwise,  the  request  is  not
             granted.  If XmNresizable is False, the request is  granted  only
             if the child's size can remain the same.

          o  A  left  (or right) attachment of XmATTACH_WIDGET, where XmNleft-
             Widget (or XmNrightWidget) is NULL, acts like  an  attachment  of
             XmATTACH_FORM.

          o  If  an  attachment is made to a widget that is not a child of the
             Form, but an ancestor of the widget is a child of the  Form,  the
             attachment is made to the ancestor.

       All  these  considerations  are  true  of top and bottom attachments as
       well, with top acting like left, bottom acting  like  right,  y  acting
       like x, and height acting like width.

   Classes
       Form  inherits  behavior,  resources,  and traits from Core, Composite,
       Constraint, XmManager, and XmBulletinBoard.

       The class pointer is xmFormWidgetClass.

       The class name is XmForm.

   New Resources
       The following table defines a set of widget resources used by the  pro-
       grammer  to specify data. The programmer can also set the resource val-
       ues for the inherited classes to set attributes for  this  widget.   To
       reference  a  resource by name or by class in a .Xdefaults file, remove
       the XmN or XmC prefix and use the remaining letters.  To specify one of
       the  defined  values for a resource in a .Xdefaults file, remove the Xm
       prefix and use the remaining letters (in either lowercase or uppercase,
       but  include  any  underscores  between words). The codes in the access
       column indicate if the given resource can be set at creation time  (C),
       set by using XtSetValues (S), retrieved by using XtGetValues (G), or is
       not applicable (N/A).


       +---------------------------------------------------------------------------+
       |                     |     XmForm Resource Set          |         |        |
       |Name                 | Class                | Type      | Default | Access |
       +---------------------+----------------------+-----------+---------+--------+
       |XmNfractionBase      | XmCMaxValue          | int       | 100     | CSG    |
       +---------------------+----------------------+-----------+---------+--------+
       |XmNhorizontalSpacing | XmCSpacing           | Dimension | 0       | CSG    |
       +---------------------+----------------------+-----------+---------+--------+
       |XmNrubberPositioning | XmCRubberPositioning | Boolean   | False   | CSG    |
       +---------------------+----------------------+-----------+---------+--------+
       |XmNverticalSpacing   | XmCSpacing           | Dimension | 0       | CSG    |
       +---------------------+----------------------+-----------+---------+--------+
       +---------------------+----------------------+-----------+---------+--------+
       XmNfractionBase
                 Specifies the denominator used in  calculating  the  relative
                 position  of  a  child  widget  using  XmATTACH_POSITION con-
                 straints.  The value must not be 0 (zero).

                 If the value of a child's XmNleftAttachment  (or  XmNrightAt-
                 tachment)  is XmATTACH_POSITION, the position of the left (or
                 right) side of the child is relative to the left side of  the
                 Form  and is a fraction of the width of the Form.  This frac-
                 tion is the value of the  child's  XmNleftPosition  (or  XmN-
                 rightPosition)  resource  divided  by the value of the Form's
                 XmNfractionBase.

                 If the value of a child's XmNtopAttachment  (or  XmNbottomAt-
                 tachment)  is  XmATTACH_POSITION, the position of the top (or
                 bottom) side of the child is relative to the top side of  the
                 Form and is a fraction of the height of the Form.  This frac-
                 tion is the value of the child's XmNtopPosition  (or  XmNbot-
                 tomPosition) resource divided by the value of the Form's XmN-
                 fractionBase.

       XmNhorizontalSpacing
                 Specifies the offset for right  and  left  attachments.  This
                 resource  is  only  used  if  no offset resource is specified
                 (when attaching to a widget), or if  no  margin  resource  is
                 specified (when attaching to the Form).

       XmNrubberPositioning
                 Indicates  the  default near (left) and top attachments for a
                 child of the Form.  (Note that whether this resource actually
                 applies  to  the  left  or  right  side  of the child and its
                 attachment depends on the value of the XmNlayoutDirection.)

                 The default left attachment is applied  whenever  initializa-
                 tion or XtSetValues leaves the child without either a left or
                 right attachment.  The  default  top  attachment  is  applied
                 whenever initialization or XtSetValues leaves the child with-
                 out either a top or bottom attachment.

                 If this Boolean resource is set to  False,  XmNleftAttachment
                 and  XmNtopAttachment default to XmATTACH_FORM, XmNleftOffset
                 defaults to the current x value  of  the  left  side  of  the
                 child,  and  XmNtopOffset  defaults to the current y value of
                 the child.  The effect is to position the child according  to
                 its  absolute distance from the left or top side of the Form.

                 If this resource is set to True, XmNleftAttachment  and  XmN-
                 topAttachment  default  to XmATTACH_POSITION, XmNleftPosition
                 defaults to a value proportional to the current  x  value  of
                 the  left side of the child divided by the width of the Form,
                 and XmNtopPosition defaults to a value  proportional  to  the
                 current  y  value  of  the child divided by the height of the
                 Form.  The effect is to position the child  relative  to  the
                 left  or  top side of the Form and in proportion to the width
                 or height of the Form.

       XmNverticalSpacing
                 Specifies the offset for top  and  bottom  attachments.  This
                 resource  is  only  used  if  no offset resource is specified
                 (when attaching to a widget), or if  no  margin  resource  is
                 specified (when attaching to the Form).



                 +-----------------------------------------------------------------------------+
                 |                    |  XmForm Constraint Resource Set               |        |
                 |Name                | Class         | Type          | Default       | Access |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNbottomAttachment | XmCAttachment | unsigned char | XmATTACH_NONE | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNbottomOffset     | XmCOffset     | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNbottomPosition   | XmCPosition   | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNbottomWidget     | XmCWidget     | Widget        | NULL          | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNleftAttachment   | XmCAttachment | unsigned char | XmATTACH_NONE | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNleftOffset       | XmCOffset     | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNleftPosition     | XmCPosition   | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNleftWidget       | XmCWidget     | Widget        | NULL          | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNresizable        | XmCBoolean    | Boolean       | True          | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNrightAttachment  | XmCAttachment | unsigned char | XmATTACH_NONE | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNrightOffset      | XmCOffset     | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNrightPosition    | XmCPosition   | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNrightWidget      | XmCWidget     | Widget        | NULL          | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNtopAttachment    | XmCAttachment | unsigned char | XmATTACH_NONE | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNtopOffset        | XmCOffset     | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNtopPosition      | XmCPosition   | int           | 0             | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 |XmNtopWidget        | XmCWidget     | Widget        | NULL          | CSG    |
                 +--------------------+---------------+---------------+---------------+--------+
                 +--------------------+---------------+---------------+---------------+--------+
       XmNbottomAttachment
                 Specifies  attachment of the bottom side of the child. It can
                 have the following values:

                 XmATTACH_NONE
                           Do not attach the bottom side of the child.

                 XmATTACH_FORM
                           Attach the bottom side of the child to  the  bottom
                           side of the Form.

                 XmATTACH_OPPOSITE_FORM
                           Attach the bottom side of the child to the top side
                           of the Form.  XmNbottomOffset can be used to deter-
                           mine the visibility of the child.

                 XmATTACH_WIDGET
                           Attach the bottom side of the child to the top side
                           of the widget or gadget specified  in  the  XmNbot-
                           tomWidget  resource.   If  XmNbottomWidget is NULL,
                           XmATTACH_WIDGET is replaced by  XmATTACH_FORM,  and
                           the  child  is  attached  to the bottom side of the
                           Form.

                 XmATTACH_OPPOSITE_WIDGET
                           Attach the bottom side of the child to  the  bottom
                           side  of the widget or gadget specified in the XmN-
                           bottomWidget resource.

                 XmATTACH_POSITION
                           Attach the bottom side of the child to  a  position
                           that is relative to the top side of the Form and in
                           proportion to the height of the Form.   This  posi-
                           tion  is  determined  by  the XmNbottomPosition and
                           XmNfractionBase resources.

                 XmATTACH_SELF
                           Attach the bottom side of the child to  a  position
                           that  is proportional to the current y value of the
                           bottom of the child divided by the  height  of  the
                           Form.   This  position is determined by the XmNbot-
                           tomPosition and XmNfractionBase resources.  XmNbot-
                           tomPosition  is  set to a value proportional to the
                           current y value of the bottom of the child  divided
                           by the height of the Form.

       XmNbottomOffset
                 Specifies  the constant offset between the bottom side of the
                 child and the object to which it is attached.  The  relation-
                 ship  established  remains, regardless of any resizing opera-
                 tions that occur.  When this resource is explicitly set,  the
                 value of XmNverticalSpacing is ignored.

       XmNbottomPosition
                 This resource is used to determine the position of the bottom
                 side of the child when the child's XmNbottomAttachment is set
                 to  XmATTACH_POSITION.  In this case the position of the bot-
                 tom side of the child is relative to the top side of the Form
                 and  is  a fraction of the height of the Form.  This fraction
                 is  the  value  of  the  child's  XmNbottomPosition  resource
                 divided  by  the  value  of  the Form's XmNfractionBase.  For
                 example, if the child's XmNbottomPosition is 50,  the  Form's
                 XmNfractionBase  is  100,  and  the Form's height is 200, the
                 position of the bottom side of the child is 100.

       XmNbottomWidget
                 Specifies the widget or gadget to which the  bottom  side  of
                 the  child is attached.  This resource is used if the XmNbot-
                 tomAttachment resource is set to  either  XmATTACH_WIDGET  or
                 XmATTACH_OPPOSITE_WIDGET.

                 A   string-to-widget   resource  converter  is  automatically
                 installed for use with this resource.  With  this  converter,
                 the widget that is to be the value of the resource must exist
                 at the time the widget that has the resource is created.

       XmNleftAttachment
                 Specifies attachment of the near (left) side  of  the  child.
                 (Note that whether this resource actually applies to the left
                 or right side of the child and its attachment depends on  the
                 value  of  the XmNlayoutDirection resource.)  It can have the
                 following values:

                 XmATTACH_NONE
                           Do not attach the left side of the child.  If  XmN-
                           rightAttachment  is  also XmATTACH_NONE, this value
                           is ignored and the child is given  a  default  left
                           attachment.

                 XmATTACH_FORM
                           Attach  the left side of the child to the left side
                           of the Form.

                 XmATTACH_OPPOSITE_FORM
                           Attach the left side of the child to the right side
                           of  the  Form.  XmNleftOffset can be used to deter-
                           mine the visibility of the child.

                 XmATTACH_WIDGET
                           Attach the left side of the child to the right side
                           of  the  widget or gadget specified in the XmNleft-
                           Widget resource.  If XmNleftWidget is  NULL,  XmAT-
                           TACH_WIDGET  is  replaced by XmATTACH_FORM, and the
                           child is attached to the left side of the Form.

                 XmATTACH_OPPOSITE_WIDGET
                           Attach the left side of the child to the left  side
                           of  the  widget or gadget specified in the XmNleft-
                           Widget resource.

                 XmATTACH_POSITION
                           Attach the left side of the  child  to  a  position
                           that  is  relative to the left side of the Form and
                           in proportion to the width of the Form.  This posi-
                           tion  is determined by the XmNleftPosition and XmN-
                           fractionBase resources.

                 XmATTACH_SELF
                           Attach the left side of the  child  to  a  position
                           that  is proportional to the current x value of the
                           left side of the child divided by the width of  the
                           Form.   This position is determined by the XmNleft-
                           Position and XmNfractionBase resources.  XmNleftPo-
                           sition  is  set to a value proportional to the cur-
                           rent x value of the left side of the child  divided
                           by the width of the Form.

       XmNleftOffset
                 Specifies the constant offset between the near (left) side of
                 the child and the object to which it is attached.  (Note that
                 whether  this  resource actually applies to the left or right
                 side of the child and its attachment depends on the value  of
                 the  XmNlayoutDirection  resource.)   The relationship estab-
                 lished remains, regardless of any  resizing  operations  that
                 occur.   When  this  resource is explicitly set, the value of
                 XmNhorizontalSpacing is ignored.

       XmNleftPosition
                 This resource is used to determine the position of  the  near
                 (left)  side  of the child when the child's XmNleftAttachment
                 is  set  to  XmATTACH_POSITION.   (Note  that  whether   this
                 resource  actually  applies  to the left or right side of the
                 child and its attachment depends on the value of the  XmNlay-
                 outDirection resource.)

                 In  this  case, the position of the left side of the child is
                 relative to the left side of the Form and is  a  fraction  of
                 the  width  of  the  Form.  This fraction is the value of the
                 child's XmNleftPosition resource divided by the value of  the
                 Form's XmNfractionBase.  For example, if the child's XmNleft-
                 Position is 50, the Form's XmNfractionBase is  100,  and  the
                 Form's  width  is  200,  the position of the left side of the
                 child is 100.

       XmNleftWidget
                 Specifies the widget or gadget to which the near (left)  side
                 of  the  child is attached.  (Note that whether this resource
                 actually applies to the left or right side of the  child  and
                 its attachment depends on the value of the XmNlayoutDirection
                 resource.)  The XmNleftWidget resource is used if the XmNlef-
                 tAttachment  resource  is  set  to  either XmATTACH_WIDGET or
                 XmATTACH_OPPOSITE_WIDGET.

                 A  string-to-widget  resource  converter   is   automatically
                 installed  for  use with this resource.  With this converter,
                 the widget that is to be the value of the resource must exist
                 at the time the widget that has the resource is created.

       XmNresizable
                 This  Boolean  resource  specifies  whether  or not a child's
                 request for a new size  is  (conditionally)  granted  by  the
                 Form.  If this resource is set to True the request is granted
                 if possible.  If this resource is set to False the request is
                 always refused.

                 If  a child has both left and right attachments, its width is
                 completely controlled by the Form, regardless of the value of
                 the  child's XmNresizable resource.  If a child has a left or
                 right attachment but not both, the child's XmNwidth  is  used
                 in setting its width if the value of the child's XmNresizable
                 resource is True.  These conditions are also true for top and
                 bottom attachments, with height acting like width.

       XmNrightAttachment
                 Specifies  attachment  of  the far (right) side of the child.
                 (Note that whether this resource actually applies to the left
                 or  right side of the child and its attachment depends on the
                 value of the XmNlayoutDirection resource.)  It can  have  the
                 following values:

                 XmATTACH_NONE
                           Do not attach the right side of the child.

                 XmATTACH_FORM
                           Attach  the  right  side  of the child to the right
                           side of the Form.

                 XmATTACH_OPPOSITE_FORM
                           Attach the right side of the child to the left side
                           of  the Form.  XmNrightOffset can be used to deter-
                           mine the visibility of the child.

                 XmATTACH_WIDGET
                           Attach the right side of the child to the left side
                           of  the  widget  or  gadget  specified  in the XmN-
                           rightWidget resource.  If XmNrightWidget  is  NULL,
                           XmATTACH_WIDGET  is  replaced by XmATTACH_FORM, and
                           the child is attached to  the  right  side  of  the
                           Form.

                 XmATTACH_OPPOSITE_WIDGET
                           Attach  the  right  side  of the child to the right
                           side of the widget or gadget specified in the  XmN-
                           rightWidget resource.

                 XmATTACH_POSITION
                           Attach  the  right  side of the child to a position
                           that is relative to the left side of the  Form  and
                           in proportion to the width of the Form.  This posi-
                           tion is determined by the XmNrightPosition and XmN-
                           fractionBase resources.

                 XmATTACH_SELF
                           Attach  the  right  side of the child to a position
                           that is proportional to the current x value of  the
                           right side of the child divided by the width of the
                           Form.  This position is determined by the XmNright-
                           Position  and XmNfractionBase resources.  XmNright-
                           Position is set to a value proportional to the cur-
                           rent x value of the right side of the child divided
                           by the width of the Form.

       XmNrightOffset
                 Specifies the constant offset between the far (right) side of
                 the child and the object to which it is attached.  (Note that
                 whether this resource actually applies to the left  or  right
                 side  of the child and its attachment depends on the value of
                 the XmNlayoutDirection resource.)   The  relationship  estab-
                 lished  remains,  regardless  of any resizing operations that
                 occur.  When this resource is explicitly set,  the  value  of
                 XmNhorizontalSpacing is ignored.

       XmNrightPosition
                 This  resource  is  used to determine the position of the far
                 (right) side of the child when the child's XmNrightAttachment
                 is   set  to  XmATTACH_POSITION.   (Note  that  whether  this
                 resource actually applies to the left or right  side  of  the
                 child  and its attachment depends on the value of the XmNlay-
                 outDirection resource.)

                 In this case the position of the right side of the  child  is
                 relative  to  the  left side of the Form and is a fraction of
                 the width of the Form.  This fraction is  the  value  of  the
                 child's XmNrightPosition resource divided by the value of the
                 Form's XmNfractionBase.  For example,  if  the  child's  XmN-
                 rightPosition  is  50, the Form's XmNfractionBase is 100, and
                 the Form's width is 200, the position of the  right  side  of
                 the child is 100.

       XmNrightWidget
                 Specifies  the widget or gadget to which the far (right) side
                 of the child is attached.  (Note that whether  this  resource
                 actually  applies  to the left or right side of the child and
                 its attachment depends on the value of the XmNlayoutDirection
                 resource.)   The  XmNrightWidget resource is used if the XmN-
                 rightAttachment resource is set to either XmATTACH_WIDGET  or
                 XmATTACH_OPPOSITE_WIDGET.

                 A   string-to-widget   resource  converter  is  automatically
                 installed for use with this resource.  With  this  converter,
                 the widget that is to be the value of the resource must exist
                 at the time the widget that has the resource is created.

       XmNtopAttachment
                 Specifies attachment of the top side of  the  child.  It  can
                 have following values:

                 XmATTACH_NONE
                           Do  not  attach  the top side of the child.  If the
                           XmNbottomAttachment resource is also XmATTACH_NONE,
                           this  value  is  ignored  and  the child is given a
                           default top attachment.

                 XmATTACH_FORM
                           Attach the top side of the child to the top side of
                           the Form.

                 XmATTACH_OPPOSITE_FORM
                           Attach the top side of the child to the bottom side
                           of the Form.  XmNtopOffset can be used to determine
                           the visibility of the child.

                 XmATTACH_WIDGET
                           Attach the top side of the child to the bottom side
                           of the widget or gadget specified in the XmNtopWid-
                           get  resource.   If  XmNtopWidget  is  NULL,  XmAT-
                           TACH_WIDGET is replaced by  XmATTACH_FORM  and  the
                           child is attached to the top side of the Form.

                 XmATTACH_OPPOSITE_WIDGET
                           Attach the top side of the child to the top side of
                           the widget or gadget specified in the  XmNtopWidget
                           resource.

                 XmATTACH_POSITION
                           Attach the top side of the child to a position that
                           is relative to the top side of the Form and in pro-
                           portion  to  the height of the Form.  This position
                           is determined by the  XmNtopPosition  and  XmNfrac-
                           tionBase resources.

                 XmATTACH_SELF
                           Attach the top side of the child to a position that
                           is proportional to the current y value of the child
                           divided  by  the height of the Form.  This position
                           is determined by the  XmNtopPosition  and  XmNfrac-
                           tionBase  resources.   XmNtopPosition  is  set to a
                           value proportional to the current y  value  of  the
                           child divided by the height of the Form.

       XmNtopOffset
                 Specifies  the  constant  offset  between the top side of the
                 child and the object to which it is attached.  The  relation-
                 ship  established  remains, regardless of any resizing opera-
                 tions that occur.  When this resource is explicitly set,  the
                 value of XmNverticalSpacing is ignored.

       XmNtopPosition
                 This  resource  is  used to determine the position of the top
                 side of the child when the child's XmNtopAttachment is set to
                 XmATTACH_POSITION.   In  this  case,  the position of the top
                 side of the child is relative to the top side of the Form and
                 is  a  fraction  of the height of the Form.  This fraction is
                 the value of the child's XmNtopPosition resource  divided  by
                 the value of the Form's XmNfractionBase.  For example, if the
                 child's XmNtopPosition is 50, the Form's  XmNfractionBase  is
                 100,  and  the  Form's height is 200, the position of the top
                 side of the child is 100.

       XmNtopWidget
                 Specifies the widget or gadget to which the top side  of  the
                 child is attached.  This resource is used if XmNtopAttachment
                 is set to a value of either XmATTACH_WIDGET or XmATTACH_OPPO-
                 SITE_WIDGET.

                 A   string-to-widget   resource  converter  is  automatically
                 installed for use with this resource.  With  this  converter,
                 the widget that is to be the value of the resource must exist
                 at the time the widget that has the resource is created.

   Inherited Resources
       Form inherits behavior and resources from the superclasses described in
       the  following  tables.   For  a complete description of each resource,
       refer to the reference page for that superclass.


       +-------------------------------------------------------------------------------------+
       |                     |      XmBulletinBoard Resource Set     |              |        |
       |Name                 | Class                | Type           | Default      | Access |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNallowOverlap      | XmCAllowOverlap      | Boolean        | True         | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNautoUnmanage      | XmCAutoUnmanage      | Boolean        | True         | CG     |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNbuttonFontList    | XmCButtonFontList    | XmFontList     | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNbuttonRenderTable | XmCButtonRenderTable | XmRenderTable  | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNcancelButton      | XmCWidget            | Widget         | NULL         | SG     |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNdefaultButton     | XmCWidget            | Widget         | NULL         | SG     |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNdefaultPosition   | XmCDefaultPosition   | Boolean        | True         | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNdialogStyle       | XmCDialogStyle       | unsigned char  | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNdialogTitle       | XmCDialogTitle       | XmString       | NULL         | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNfocusCallback     | XmCCallback          | XtCallbackList | NULL         | C      |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNlabelFontList     | XmCLabelFontList     | XmFontList     | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNlabelRenderTable  | XmCLabelRenderTable  | XmRenderTable  | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNmapCallback       | XmCCallback          | XtCallbackList | NULL         | C      |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNmarginHeight      | XmCMarginHeight      | Dimension      | 0            | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNmarginWidth       | XmCMarginWidth       | Dimension      | 0            | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNnoResize          | XmCNoResize          | Boolean        | False        | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNresizePolicy      | XmCResizePolicy      | unsigned char  | XmRESIZE_ANY | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNshadowType        | XmCShadowType        | unsigned char  | XmSHADOW_OUT | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNtextFontList      | XmCTextFontList      | XmFontList     | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNtextRenderTable   | XmCTextRenderTable   | XmRenderTable  | dynamic      | CSG    |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNtextTranslations  | XmCTranslations      | XtTranslations | NULL         | C      |
       +---------------------+----------------------+----------------+--------------+--------+
       |XmNunmapCallback     | XmCCallback          | XtCallbackList | NULL         | C      |
       +---------------------+----------------------+----------------+--------------+--------+
       +---------------------+----------------------+----------------+--------------+--------+

       +----------------------------------------------------------------------------------------------------+
       |                        |             XmManager Resource Set        |                      |        |
       |Name                    | Class                 | Type              | Default              | Access |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNbottomShadowColor    | XmCBottomShadowColor  | Pixel             | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNbottomShadowPixmap   | XmCBottomShadowPixmap | Pixmap            | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNforeground           | XmCForeground         | Pixel             | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhelpCallback         | XmCCallback           | XtCallbackList    | NULL                 | C      |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhighlightColor       | XmCHighlightColor     | Pixel             | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNhighlightPixmap      | XmCHighlightPixmap    | Pixmap            | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNinitialFocus         | XmCInitialFocus       | Widget            | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNlayoutDirection      | XmCLayoutDirection    | XmDirection       | dynamic              | CG     |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNnavigationType       | XmCNavigationType     | XmNavigationType  | XmTAB_GROUP          | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNpopupHandlerCallback | XmCCallback           | XtCallbackList    | NULL                 | C      |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNshadowThickness      | XmCShadowThickness    | Dimension         | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNstringDirection      | XmCStringDirection    | XmStringDirection | dynamic              | CG     |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtopShadowColor       | XmCTopShadowColor     | Pixel             | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtopShadowPixmap      | XmCTopShadowPixmap    | Pixmap            | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNtraversalOn          | XmCTraversalOn        | Boolean           | True                 | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNunitType             | XmCUnitType           | unsigned char     | dynamic              | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       |XmNuserData             | XmCUserData           | XtPointer         | NULL                 | CSG    |
       +------------------------+-----------------------+-------------------+----------------------+--------+
       +------------------------+-----------------------+-------------------+----------------------+--------+

       +-----------------------------------------------------------------------+
       |                  |     Composite Resource Set      |         |        |
       |Name              | Class             | Type        | Default | Access |
       +------------------+-------------------+-------------+---------+--------+
       |XmNchildren       | XmCReadOnly       | WidgetList  | NULL    | G      |
       +------------------+-------------------+-------------+---------+--------+
       |XmNinsertPosition | XmCInsertPosition | XtOrderProc | NULL    | CSG    |
       +------------------+-------------------+-------------+---------+--------+
       |XmNnumChildren    | XmCReadOnly       | Cardinal    | 0       | G      |
       +------------------+-------------------+-------------+---------+--------+
       +------------------+-------------------+-------------+---------+--------+

       +---------------------------------------------------------------------------------------------------------------+
       |                              |               Core Resource Set                |                      |        |
       |Name                          | Class                         | Type           | Default              | Access |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNaccelerators               | XmCAccelerators               | XtAccelerators | dynamic              | N/A    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNancestorSensitive          | XmCSensitive                  | Boolean        | dynamic              | G      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackground                 | XmCBackground                 | Pixel          | dynamic              | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNbackgroundPixmap           | XmCPixmap                     | Pixmap         | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderColor                | XmCBorderColor                | Pixel          | XtDefaultForeground  | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderPixmap               | XmCPixmap                     | Pixmap         | XmUNSPECIFIED_PIXMAP | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNborderWidth                | XmCBorderWidth                | Dimension      | 0                    | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNcolormap                   | XmCColormap                   | Colormap       | dynamic              | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdepth                      | XmCDepth                      | int            | dynamic              | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNdestroyCallback            | XmCCallback                   | XtCallbackList | NULL                 | C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNheight                     | XmCHeight                     | Dimension      | dynamic              | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNinitialResourcesPersistent | XmCInitialResourcesPersistent | Boolean        | True                 | C      |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNmappedWhenManaged          | XmCMappedWhenManaged          | Boolean        | True                 | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNscreen                     | XmCScreen                     | Screen *       | dynamic              | CG     |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNsensitive                  | XmCSensitive                  | Boolean        | True                 | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNtranslations               | XmCTranslations               | XtTranslations | dynamic              | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNwidth                      | XmCWidth                      | Dimension      | dynamic              | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNx                          | XmCPosition                   | Position       | 0                    | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       |XmNy                          | XmCPosition                   | Position       | 0                    | CSG    |
       +------------------------------+-------------------------------+----------------+----------------------+--------+
       +------------------------------+-------------------------------+----------------+----------------------+--------+
   Translations
       XmForm inherits translations from XmBulletinBoard.


RELATED

       Composite(3), Constraint(3), Core(3), XmBulletinBoard(3), XmCreateForm(3),
       XmCreateFormDialog(3), XmManager(3), XmVaCreateForm(3), and XmVaCreateMan-
       agedForm(3).



                                                          XmForm(library call)

openMotif 2.3.1 - Generated Sun Nov 30 15:44:02 CST 2008
© manpagez.com 2000-2024
Individual documents may contain additional copyright information.