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

	    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.

	    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  re-
	     quest  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	current	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 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.

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

	    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.

	    A left (or	right) attachment of XmATTACH_WIDGET,  where  XmNleft-
	     Widget  (or  XmNrightWidget)  is NULL, acts like an attachment of
	     XmATTACH_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,
       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 re-
		 source	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  at-
		 tachment 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 re-
		 source	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 Xm-
			   NfractionBase 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 di-
		 vided by the value of the Form's XmNfractionBase.  For	 exam-
		 ple,  if the child's XmNbottomPosition	is 50, the Form's XmN-
		 fractionBase is 100, and the Form's height is 200, the	 posi-
		 tion 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  in-
		 stalled 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 re-
		 source	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  in-
		 stalled 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  re-
		 quest	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 re-
		 source	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 in-
		 stalled 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 de-
			   fault 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  in-
		 stalled 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, re-
       fer 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,
       XmCreateFormDialog(3), XmManager(3), XmVaCreateForm, and	XmVaCreateMan-
       agedForm.

								     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+14.3.quarterly>

home | help