Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
XmForm(3)		    Library Functions Manual		       XmForm(3)

NAME
     XmForm -- The Form widget class

SYNOPSIS
     #include <Xm/Form.h>

DESCRIPTION
     Form is a container widget with no input semantics of its own.  Constraints
     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 determine 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:

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

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

	       If XmNrubberPositioning is True, the child is given an XmNleftAt-
	       tachment 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.

	*  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.

	*  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.

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

	*  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.

	*  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 cur-
	   rent width).  This may cause it to be clipped by the Form or by other
	   children.

	*  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 at-
	   tachment is then changed to XmATTACH_POSITION, with a  position  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.

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

	*  Unmanaging  a  child unmaps it.  If no other child is attached to it,
	   or if all children attached to it and all  children	recursively  at-
	   tached  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.

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

	*  A  left (or right) attachment of XmATTACH_WIDGET, where XmNleftWidget
	   (or XmNrightWidget)	is  NULL,  acts  like  an  attachment  of  XmAT-
	   TACH_FORM.

	*  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,  Con-
     straint, 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 program-
     mer to specify data. The programmer can also set the  resource  values  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 re-
     maining letters (in either lowercase or uppercase, but include  any  under-
     scores 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), re-
     trieved 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 posi-
	       tion of a child widget using XmATTACH_POSITION constraints.   The
	       value must not be 0 (zero).

	       If  the	value of a child's XmNleftAttachment (or XmNrightAttach-
	       ment) 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 fraction is the value
	       of the child's XmNleftPosition (or XmNrightPosition) resource di-
	       vided by the value of the Form's XmNfractionBase.

	       If the value of a child's XmNtopAttachment  (or	XmNbottomAttach-
	       ment)  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 fraction is the value
	       of the child's XmNtopPosition (or XmNbottomPosition) resource di-
	       vided by the value of the Form's XmNfractionBase.

     XmNhorizontalSpacing
	       Specifies  the  offset  for  right and left attachments. This re-
	       source is only used if no offset resource is specified (when  at-
	       taching 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 initialization or
	       XtSetValues leaves the child without either a left or  right  at-
	       tachment.   The	default  top attachment is applied whenever ini-
	       tialization or XtSetValues leaves the child without 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  XmN-
	       topOffset  defaults to the current y value of the child.  The ef-
	       fect 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 XmNtopAt-
	       tachment 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 posi-
	       tion 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 re-
	       source is only used if no offset resource is specified (when  at-
	       taching 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 determine 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  XmNbottomWidget
			 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 XmNbottomWid-
			 get 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 propor-
			 tion to the height of the Form.  This position  is  de-
			 termined  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 po-
			 sition is determined by the XmNbottomPosition and  XmN-
			 fractionBase  resources.  XmNbottomPosition 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 relationship
	       established remains, regardless of any resizing	operations  that
	       occur.	When  this resource is explicitly set, the value of XmN-
	       verticalSpacing 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 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 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 XmNbot-
	       tomPosition 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 XmNbottomAttach-
	       ment  resource is set to 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.

     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	XmNrigh-
			 tAttachment  is  also	XmATTACH_NONE, this value is ig-
			 nored 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  determine  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 XmNleftWidget re-
			 source.  If XmNleftWidget is NULL,  XmATTACH_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 XmNleftWidget re-
			 source.

	       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 position is  determined
			 by the XmNleftPosition and XmNfractionBase 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 posi-
			 tion  is determined by the XmNleftPosition and XmNfrac-
			 tionBase resources.  XmNleftPosition is set to a  value
			 proportional to the current 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 XmNlayoutDi-
	       rection resource.)  The relationship established remains, regard-
	       less 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 actu-
	       ally  applies  to the left or right side of the child and its at-
	       tachment depends on  the  value	of  the  XmNlayoutDirection  re-
	       source.)

	       In this case, the position of the left side of the child is rela-
	       tive  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	XmNleft-
	       Position resource divided by the value of the Form's XmNfraction-
	       Base.   For  example,  if  the child's XmNleftPosition 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 XmNleftAttachment 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 com-
	       pletely	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 attach-
	       ments, 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 determine 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 XmNrightWidget
			 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 XmNrightWidget
			 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 propor-
			 tion to the width of the Form.  This position is deter-
			 mined	by  the XmNrightPosition and XmNfractionBase re-
			 sources.

	       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 XmNrightPosition and
			 XmNfractionBase  resources.  XmNrightPosition is set to
			 a value proportional to the  current  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 XmNlayoutDi-
	       rection resource.)  The relationship established remains, regard-
	       less  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 actu-
	       ally applies to the left or right side of the child and	its  at-
	       tachment  depends  on  the  value  of  the XmNlayoutDirection re-
	       source.)

	       In this case the position of the right side of the child is rela-
	       tive 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 XmNright-
	       Position resource divided by the value of the Form's XmNfraction-
	       Base.   For  example,  if the child's XmNrightPosition 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 XmNrightAttachment re-
	       source is set to either XmATTACH_WIDGET or XmATTACH_OPPOSITE_WID-
	       GET.

	       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 XmN-
			 bottomAttachment 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 XmNtopWidget re-
			 source.  If XmNtopWidget is  NULL,  XmATTACH_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  re-
			 source.

	       XmATTACH_POSITION
			 Attach  the top 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 position is determined
			 by the XmNtopPosition and XmNfractionBase resources.

	       XmATTACH_SELF
			 Attach  the top side of the child to a position that is
			 proportional to the current y value of  the  child  di-
			 vided	by the height of the Form.  This position is de-
			 termined by the XmNtopPosition and XmNfractionBase  re-
			 sources.  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 relationship estab-
	       lished remains, regardless of any resizing operations that occur.
	       When this resource is explicitly  set,  the  value  of  XmNverti-
	       calSpacing 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  XmAT-
	       TACH_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  XmNtopPosi-
	       tion  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_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.

   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, Xm-
     CreateFormDialog(3),  XmManager(3),  XmVaCreateForm, and XmVaCreateManaged-
     Form.

								       XmForm(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmForm&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help