


XmForm(3X)							   XmForm(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmFFoorrmm - The Form widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//FFoorrmm..h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	XXmmNNiinniittiiaallFFooccuuss	is the value of	XXmmNNddeeffaauullttBBuuttttoonn.

  Following are	some important considerations in using a Form:

    oo++  Every child must	have an	attachment on either the left or the right.
       If initialization or XXttSSeettVVaalluueess	leaves a widget	without	such an
       attachment, the result depends upon the value of	XXmmNNrruubbbbeerrPPoossiittiioonniinngg.

       If XXmmNNrruubbbbeerrPPoossiittiioonniinngg is False, the child is given an XXmmNNlleeffttAAttttaacchh--
       mmeenntt of XXmmAATTTTAACCHH__FFOORRMM and an XXmmNNlleeffttOOffffsseett equal	to its current _x
       value.

       If XXmmNNrruubbbbeerrPPoossiittiioonniinngg is True,	the child is given an XXmmNNlleeffttAAttttaacchh--
       mmeenntt of XXmmAATTTTAACCHH__PPOOSSIITTIIOONN and an	XXmmNNlleeffttPPoossiittiioonn	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, which places the child at the left	side
       of the Form.

    oo++  If you want to create a child without any attachments, and then later
       (e.g., after creating and managing it, but before realizing it) give
       it a right attachment via XXttSSeettVVaalluueess, you must set its XXmmNNlleeffttAAttttaacchh--
       mmeenntt to XXmmAATTTTAACCHH__NNOONNEE at	the same time.

    oo++  The XXmmNNrreessiizzaabbllee	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o++  Every child has a preferred width, based	on geometry requests it	makes
       (whether	they are granted or not).

    o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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o++  If a child's left (or right) attachment is set to XXmmAATTTTAACCHH__SSEELLFF,	its
       corresponding left (or right) offset is forced to 0.  The attachment
       is then changed to XXmmAATTTTAACCHH__PPOOSSIITTIIOONN, with a position that corresponds
       to _x value of the child's left (or right) edge.	To fix the position
       of a side at a specific _x value use XXmmAATTTTAACCHH__FFOORRMM or
       XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__FFOORRMM with the _x value as the left (or right) offset.

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

    oo++  Unmanaging a child unmaps it.  If no other child	is attached to it, or
       if all children attached	to it and all children recursively 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o++  When using XXttSSeettVVaalluueess to change	the XXmmNNxx resource of a child, you
       must simultaneously set its left	attachment to either XXmmAATTTTAACCHH__SSEELLFF or
       XXmmAATTTTAACCHH__NNOONNEE.  Otherwise, the request is not granted.  If XXmmNNrreessiizz--
       aabbllee is False, the request is granted only if the child's size can
       remain the same.

    oo++  A left (or right) attachment of XXmmAATTTTAACCHH__WWIIDDGGEETT,	where XXmmNNlleeffttWWiiddggeett
       (or XXmmNNrriigghhttWWiiddggeett) is NULL, acts like an attachment of XXmmAATTTTAACCHH__FFOORRMM.

    o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 and resources from CCoorree, CCoommppoossiittee, CCoonnssttrraaiinntt,
  XXmmMMaannaaggeerr, and XXmmBBuulllleettiinnBBooaarrdd classes.

  The class pointer is xxmmFFoorrmmWWiiddggeettCCllaassss.

  The class name is XXmmFFoorrmm.

  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	XXmmNN or XXmmCC
  prefix and use the remaining letters.	 To specify one	of the defined values
  for a	resource in a .Xdefaults file, remove the XXmm prefix and	use the









  remaining 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 XXttSSeettVVaalluueess
  (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable	(N/A).


			     XXmmFFoorrmm RReessoouurrccee SSeett
	    ______________________________________________________
	    NNaammee			 DDeeffaauulltt	    AAcccceessss
		  CCllaassss			       TTyyppee
	    ______________________________________________________
	    ______________________________________________________
	    XmNfractionBase		 100		    CSG
		  XmCMaxValue			int
	    ______________________________________________________
	    XmNhorizontalSpacing	 0		    CSG
		  XmCSpacing			Dimension
	    ______________________________________________________
	    XmNrubberPositioning	 False		    CSG
		  XmCRubberPositioning		Boolean
	    ______________________________________________________
	    XmNverticalSpacing		 0		    CSG
		  XmCSpacing			Dimension
	    ______________________________________________________

  XXmmNNffrraaccttiioonnBBaassee
	    Specifies the denominator used in calculating the relative posi-
	    tion of a child widget using XXmmAATTTTAACCHH__PPOOSSIITTIIOONN constraints.	 The
	    value must not be 0.

	    If the value of a child's XXmmNNlleeffttAAttttaacchhmmeenntt	(or XXmmNNrriigghhttAAttttaacchh--
	    mmeenntt) is XXmmAATTTTAACCHH__PPOOSSIITTIIOONN,	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 XXmmNNlleeffttPPoossiittiioonn (or XXmmNNrriigghhttPPoossiittiioonn) resource
	    divided by the value of the	Form's XXmmNNffrraaccttiioonnBBaassee.

	    If the value of a child's XXmmNNttooppAAttttaacchhmmeenntt (or XXmmNNbboottttoommAAttttaacchh--
	    mmeenntt) is XXmmAATTTTAACCHH__PPOOSSIITTIIOONN,	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 XXmmNNttooppPPoossiittiioonn (or XXmmNNbboottttoommPPoossiittiioonn) resource
	    divided by the value of the	Form's XXmmNNffrraaccttiioonnBBaassee.

  XXmmNNhhoorriizzoonnttaallSSppaacciinngg
	    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).

  XXmmNNrruubbbbeerrPPoossiittiioonniinngg
	    Indicates the default near (left) and top attachments for a	child
	    of the Form.  (NNoottee::  Whether this resource	actually applies to
	    the	left or	right side of the child	and its	attachment may depend
	    on the value of the	XXmmNNssttrriinnggDDiirreeccttiioonn resource.)

	    The	default	left attachment	is applied whenever initialization or
	    XXttSSeettVVaalluueess	leaves the child without either	a left or right
	    attachment.	 The default top attachment is applied whenever	ini-
	    tialization	or XXttSSeettVVaalluueess leaves the child	without	either a top
	    or bottom attachment.

	    If this Boolean resource is	set to False, XXmmNNlleeffttAAttttaacchhmmeenntt	and
	    XXmmNNttooppAAttttaacchhmmeenntt default to	XXmmAATTTTAACCHH__FFOORRMM, XXmmNNlleeffttOOffffsseett defaults
	    to the current _x value of the left side of the child, and XXmmNNttoo--
	    ppOOffffsseett 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, XXmmNNlleeffttAAttttaacchhmmeenntt and XXmmNNttooppAAtt--
	    ttaacchhmmeenntt default to	XXmmAATTTTAACCHH__PPOOSSIITTIIOONN, XXmmNNlleeffttPPoossiittiioonn 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 XXmmNNttooppPPoossiittiioonn
	    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.

  XXmmNNvveerrttiiccaallSSppaacciinngg
	    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).

			     XXmmFFoorrmm CCoonnssttrraaiinntt RReessoouurrccee	SSeett
		   ___________________________________________________
		   NNaammee			 DDeeffaauulltt		AAcccceessss
			 CCllaassss		       TTyyppee
		   ___________________________________________________
		   ___________________________________________________
		   XmNbottomAttachment	 XmATTACH_NONE		CSG
			 XmCAttachment		unsigned char
		   ___________________________________________________
		   XmNbottomOffset	 0			CSG
			 XmCOffset		int
		   ___________________________________________________
		   XmNbottomPosition	 0			CSG
			 XmCAttachment		int
		   ___________________________________________________
		   XmNbottomWidget	 NULL			CSG
			 XmCWidget		Widget
		   ___________________________________________________
		   XmNleftAttachment	 XmATTACH_NONE		CSG
			 XmCAttachment		unsigned char
		   ___________________________________________________
		   XmNleftOffset	 0			CSG
			 XmCOffset		int
		   ___________________________________________________
		   XmNleftPosition	 0			CSG
			 XmCAttachment		int
		   ___________________________________________________
		   XmNleftWidget	 NULL			CSG
			 XmCWidget		Widget
		   ___________________________________________________
		   XmNresizable		 True			CSG
			 XmCBoolean		Boolean
		   ___________________________________________________
		   XmNrightAttachment	 XmATTACH_NONE		CSG
			 XmCAttachment		unsigned char
		   ___________________________________________________
		   XmNrightOffset	 0			CSG
			 XmCOffset		int
		   ___________________________________________________
		   XmNrightPosition	 0			CSG
			 XmCAttachment		int
		   ___________________________________________________
		   XmNrightWidget	 NULL			CSG
			 XmCWidget		Widget
		   ___________________________________________________
		   XmNtopAttachment	 XmATTACH_NONE		CSG
			 XmCAttachment		unsigned char
		   ___________________________________________________
		   XmNtopOffset		 0			CSG
			 XmCOffset		int
		   ___________________________________________________
		   XmNtopPosition	 0			CSG
			 XmCAttachment		int
		   ___________________________________________________
		   XmNtopWidget		 NULL			CSG
			 XmCWidget		Widget
		   ___________________________________________________

  XXmmNNbboottttoommAAttttaacchhmmeenntt
	    Specifies attachment of the	bottom side of the child.  It can
	    have the following values:

	      oo++
	      XXmmAATTTTAACCHH__NNOONNEE-Do not attach the bottom side of the child.

	      oo++
	      XXmmAATTTTAACCHH__FFOORRMM-Attach the bottom side of the child	to the bottom
	      side of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__FFOORRMM-Attach the	bottom side of the child to
	      the top side of the Form.	 XXmmNNbboottttoommOOffffsseett can be	used to
	      determine	the visibility of the child.

	      oo++
	      XXmmAATTTTAACCHH__WWIIDDGGEETT-Attach the bottom	side of	the child to the top
	      side of the widget or gadget specified in	the XXmmNNbboottttoommWWiiddggeett
	      resource.	 If XXmmNNbboottttoommWWiiddggeett is NULL, XXmmAATTTTAACCHH__WWIIDDGGEETT is
	      replaced by XXmmAATTTTAACCHH__FFOORRMM, and the child is attached to the
	      bottom side of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT-Attach the bottom side of the child to
	      the bottom side of the widget or gadget specified	in the
	      XXmmNNbboottttoommWWiiddggeett resource.

	      oo++
	      XXmmAATTTTAACCHH__PPOOSSIITTIIOONN-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 position is deter-
	      mined by the XXmmNNbboottttoommPPoossiittiioonn and XXmmNNffrraaccttiioonnBBaassee resources.

	      oo++
	      XXmmAATTTTAACCHH__SSEELLFF-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	XXmmNNbboottttoommPPoossiittiioonn and XXmmNNffrraaccttiioonnBBaassee
	      resources.  XXmmNNbboottttoommPPoossiittiioonn is set to a	value proportional to
	      the current _y value of the bottom	of the child divided by	the
	      height of	the Form.

  XXmmNNbboottttoommOOffffsseett
	    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
	    XXmmNNvveerrttiiccaallSSppaacciinngg is ignored.

  XXmmNNbboottttoommPPoossiittiioonn
	    This resource is used to determine the position of the bottom
	    side of the	child when the child's XXmmNNbboottttoommAAttttaacchhmmeenntt is set to
	    XXmmAATTTTAACCHH__PPOOSSIITTIIOONN.	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 XXmmNNbboottttoommPPoossiittiioonn resource divided by the value of
	    the	Form's XXmmNNffrraaccttiioonnBBaassee.	 For example, if the child's XXmmNNbboott--
	    ttoommPPoossiittiioonn	is 50, the Form's XXmmNNffrraaccttiioonnBBaassee is 100, and the
	    Form's height is 200, the position of the bottom side of the
	    child is 100.

  XXmmNNbboottttoommWWiiddggeett
	    Specifies the widget or gadget to which the	bottom side of the
	    child is attached.	This resource is used if XXmmNNbboottttoommAAttttaacchhmmeenntt
	    is set to either XXmmAATTTTAACCHH__WWIIDDGGEETT or	XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT.

	    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.

  XXmmNNlleeffttAAttttaacchhmmeenntt
	    Specifies attachment of the	near (left) side of the	child.
	    (NNoottee::  Whether this resource actually applies to the left or
	    right side of the child and	its attachment may depend on the
	    value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.) It can have the fol-
	    lowing values:

	      oo++
	      XXmmAATTTTAACCHH__NNOONNEE-Do not attach the left side	of the child.  If
	      XXmmNNrriigghhttAAttttaacchhmmeenntt is also XXmmAATTTTAACCHH__NNOONNEE,	this value is ignored
	      and the child is given a default left attachment.

	      oo++
	      XXmmAATTTTAACCHH__FFOORRMM-Attach the left side of the	child to the left
	      side of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__FFOORRMM-Attach the	left side of the child to the
	      right side of the	Form.  XXmmNNlleeffttOOffffsseett can be used to determine
	      the visibility of	the child.

	      oo++
	      XXmmAATTTTAACCHH__WWIIDDGGEETT-Attach the left side of the child	to the right
	      side of the widget or gadget specified in	the XXmmNNlleeffttWWiiddggeett
	      resource.	 If XXmmNNlleeffttWWiiddggeett is NULL, XXmmAATTTTAACCHH__WWIIDDGGEETT is
	      replaced by XXmmAATTTTAACCHH__FFOORRMM, and the child is attached to the
	      left side	of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT-Attach the left side of the child to
	      the left side of the widget or gadget specified in the
	      XXmmNNlleeffttWWiiddggeett resource.

	      oo++
	      XXmmAATTTTAACCHH__PPOOSSIITTIIOONN-Attach the left	side of	the child to a posi-
	      tion that	is relative to the left	side of	the Form and in	pro-
	      portion to the width of the Form.	 This position is determined
	      by the XXmmNNlleeffttPPoossiittiioonn and XXmmNNffrraaccttiioonnBBaassee resources.

	      oo++
	      XXmmAATTTTAACCHH__SSEELLFF-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	XXmmNNlleeffttPPoossiittiioonn	and XXmmNNffrraaccttiioonnBBaassee
	      resources.  XXmmNNlleeffttPPoossiittiioonn 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.




  XXmmNNlleeffttOOffffsseett
	    Specifies the constant offset between the near (left) side of the
	    child and the object to which it is	attached.  (NNoottee::  Whether
	    this resource actually applies to the left or right	side of	the
	    child and its attachment may depend	on the value of	the
	    XXmmNNssttrriinnggDDiirreeccttiioonn resource.) The relationship established
	    remains, regardless	of any resizing	operations that	occur.	When
	    this resource is explicitly	set, the value of XXmmNNhhoorriizzoonnttaallSSppaacc--
	    iinngg	is ignored.

  XXmmNNlleeffttPPoossiittiioonn
	    This resource is used to determine the position of the near
	    (left) side	of the child when the child's XXmmNNlleeffttAAttttaacchhmmeenntt	is
	    set	to XXmmAATTTTAACCHH__PPOOSSIITTIIOONN.  (NNoottee::  Whether this resource actually
	    applies to the left	or right side of the child and its attachment
	    may	depend on the value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.)

	    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 XXmmNNlleefftt--
	    PPoossiittiioonn resource divided by the value of the Form's XXmmNNffrraaccttiioonn--
	    BBaassee.  For example,	if the child's XXmmNNlleeffttPPoossiittiioonn is 50, the
	    Form's XXmmNNffrraaccttiioonnBBaassee is 100, and the Form's width	is 200,	the
	    position of	the left side of the child is 100.

  XXmmNNlleeffttWWiiddggeett
	    Specifies the widget or gadget to which the	near (left) side of
	    the	child is attached.  (NNoottee::  Whether this resource actually
	    applies to the left	or right side of the child and its attachment
	    may	depend on the value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.) This
	    resource is	used if	XXmmNNlleeffttAAttttaacchhmmeenntt is set to either
	    XXmmAATTTTAACCHH__WWIIDDGGEETT or XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT.

	    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.

  XXmmNNrreessiizzaabbllee
	    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 XXmmNNrreessiizzaabbllee resource.  If a child has a left or right
	    attachment but not both, the child's XXmmNNwwiiddtthh is used in setting
	    its	width if the value of the child's XXmmNNrreessiizzaabbllee resource	is
	    True.  These conditions are	also true for top and bottom attach-
	    ments, with	height acting like width.

  XXmmNNrriigghhttAAttttaacchhmmeenntt
	    Specifies attachment of the	far (right) side of the	child.
	    (NNoottee::  Whether this resource actually applies to the left or
	    right side of the child and	its attachment may depend on the
	    value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.) It can have the fol-
	    lowing values:

	      oo++
	      XXmmAATTTTAACCHH__NNOONNEE-Do not attach the right side of the	child.

	      oo++
	      XXmmAATTTTAACCHH__FFOORRMM-Attach the right side of the child to the right
	      side of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__FFOORRMM-Attach the	right side of the child	to
	      the left side of the Form.  XXmmNNrriigghhttOOffffsseett can be	used to
	      determine	the visibility of the child.

	      oo++
	      XXmmAATTTTAACCHH__WWIIDDGGEETT-Attach the right side of the child to the	left
	      side of the widget or gadget specified in	the XXmmNNrriigghhttWWiiddggeett
	      resource.	 If XXmmNNrriigghhttWWiiddggeett is NULL, XXmmAATTTTAACCHH__WWIIDDGGEETT is
	      replaced by XXmmAATTTTAACCHH__FFOORRMM, and the child is attached to the
	      right side of the	Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT-Attach the right	side of	the child to
	      the right	side of	the widget or gadget specified in the
	      XXmmNNrriigghhttWWiiddggeett resource.

	      oo++
	      XXmmAATTTTAACCHH__PPOOSSIITTIIOONN-Attach the right side of the child to a	posi-
	      tion that	is relative to the left	side of	the Form and in	pro-
	      portion to the width of the Form.	 This position is determined
	      by the XXmmNNrriigghhttPPoossiittiioonn and XXmmNNffrraaccttiioonnBBaassee resources.

	      oo++
	      XXmmAATTTTAACCHH__SSEELLFF-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 XXmmNNrriigghhttPPoossiittiioonn and	XXmmNNffrraaccttiioonnBBaassee
	      resources.  XXmmNNrriigghhttPPoossiittiioonn 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.

  XXmmNNrriigghhttOOffffsseett
	    Specifies the constant offset between the far (right) side of the
	    child and the object to which it is	attached.  (NNoottee::  Whether
	    this resource actually applies to the left or right	side of	the
	    child and its attachment may depend	on the value of	the
	    XXmmNNssttrriinnggDDiirreeccttiioonn resource.) The relationship established
	    remains, regardless	of any resizing	operations that	occur.	When
	    this resource is explicitly	set, the value of XXmmNNhhoorriizzoonnttaallSSppaacc--
	    iinngg	is ignored.

  XXmmNNrriigghhttPPoossiittiioonn
	    This resource is used to determine the position of the far
	    (right) side of the	child when the child's XXmmNNrriigghhttAAttttaacchhmmeenntt is
	    set	to XXmmAATTTTAACCHH__PPOOSSIITTIIOONN.  (NNoottee::  Whether this resource actually
	    applies to the left	or right side of the child and its attachment
	    may	depend on the value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.)

	    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 XXmmNNrriigghhtt--
	    PPoossiittiioonn resource divided by the value of the Form's XXmmNNffrraaccttiioonn--
	    BBaassee.  For example,	if the child's XXmmNNrriigghhttPPoossiittiioonn	is 50, the
	    Form's XXmmNNffrraaccttiioonnBBaassee is 100, and the Form's width	is 200,	the
	    position of	the right side of the child is 100.

  XXmmNNrriigghhttWWiiddggeett
	    Specifies the widget or gadget to which the	far (right) side of
	    the	child is attached.  (NNoottee::  Whether this resource actually
	    applies to the left	or right side of the child and its attachment
	    may	depend on the value of the XXmmNNssttrriinnggDDiirreeccttiioonn resource.) This
	    resource is	used if	XXmmNNrriigghhttAAttttaacchhmmeenntt is set to either
	    XXmmAATTTTAACCHH__WWIIDDGGEETT or XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT.

	    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.

  XXmmNNttooppAAttttaacchhmmeenntt
	    Specifies attachment of the	top side of the	child.	It can have
	    following values:

	      oo++
	      XXmmAATTTTAACCHH__NNOONNEE-Do not attach the top side of the child.  If
	      XXmmNNbboottttoommAAttttaacchhmmeenntt is also XXmmAATTTTAACCHH__NNOONNEE, this value is
	      ignored and the child is given a default top attachment.

	      oo++
	      XXmmAATTTTAACCHH__FFOORRMM-Attach the top side	of the child to	the top	side
	      of the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__FFOORRMM-Attach the	top side of the	child to the
	      bottom side of the Form.	XXmmNNttooppOOffffsseett can be used to determine
	      the visibility of	the child.

	      oo++
	      XXmmAATTTTAACCHH__WWIIDDGGEETT-Attach the top side of the child to the bottom
	      side of the widget or gadget specified in	the XXmmNNttooppWWiiddggeett
	      resource.	 If XXmmNNttooppWWiiddggeett is NULL, XXmmAATTTTAACCHH__WWIIDDGGEETT is replaced
	      by XXmmAATTTTAACCHH__FFOORRMM,	and the	child is attached to the top side of
	      the Form.

	      oo++
	      XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT-Attach the top side of the child	to
	      the top side of the widget or gadget specified in	the
	      XXmmNNttooppWWiiddggeett resource.

	      oo++
	      XXmmAATTTTAACCHH__PPOOSSIITTIIOONN-Attach the top side of the child to a posi-
	      tion 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 XXmmNNttooppPPoossiittiioonn and	XXmmNNffrraaccttiioonnBBaassee	resources.

	      oo++
	      XXmmAATTTTAACCHH__SSEELLFF-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 XXmmNNttooppPPoossiittiioonn and	XXmmNNffrraaccttiioonnBBaassee	resources.  XXmmNNttooppPPoo--
	      ssiittiioonn is	set to a value proportional to the current _y value of
	      the child	divided	by the height of the Form.

  XXmmNNttooppOOffffsseett
	    Specifies the constant offset between the top side of the child
	    and	the object to which it is attached.  The relationship esta-
	    blished remains, regardless	of any resizing	operations that
	    occur.  When this resource is explicitly set, the value of
	    XXmmNNvveerrttiiccaallSSppaacciinngg is ignored.

  XXmmNNttooppPPoossiittiioonn
	    This resource is used to determine the position of the top side
	    of the child when the child's XXmmNNttooppAAttttaacchhmmeenntt is set to
	    XXmmAATTTTAACCHH__PPOOSSIITTIIOONN.	In this	case the position of the top side of
	    the	child is relative to the top side of the Form and is a frac-
	    tion of the	height of the Form.  This fraction is the value	of
	    the	child's	XXmmNNttooppPPoossiittiioonn resource	divided	by the value of	the
	    Form's XXmmNNffrraaccttiioonnBBaassee.  For example, if the child's XXmmNNttooppPPoossii--
	    ttiioonn is 50,	the Form's XXmmNNffrraaccttiioonnBBaassee is 100, and the Form's
	    height is 200, the position	of the top side	of the child is	100.

  XXmmNNttooppWWiiddggeett
	    Specifies the widget or gadget to which the	top side of the	child
	    is attached.  This resource	is used	if XXmmNNttooppAAttttaacchhmmeenntt is set to
	    either XXmmAATTTTAACCHH__WWIIDDGGEETT or XXmmAATTTTAACCHH__OOPPPPOOSSIITTEE__WWIIDDGGEETT.

	    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	following superclasses.	 For
  a complete description of each resource, refer to the	man page for that
  superclass.

			 XXmmBBuulllleettiinnBBooaarrdd RReessoouurrccee SSeett
	   _________________________________________________________
	   NNaammee			      DDeeffaauulltt		      AAcccceessss
		 CCllaassss			    TTyyppee
	   _________________________________________________________
	   _________________________________________________________
	   XmNallowOverlap	      True		      CSG
		 XmCAllowOverlap	     Boolean
	   _________________________________________________________
	   XmNautoUnmanage	      True		      CG
		 XmCAutoUnmanage	     Boolean
	   _________________________________________________________
	   XmNbuttonFontList	      dynamic		      CSG
		 XmCButtonFontList	     XmFontList
	   _________________________________________________________
	   XmNcancelButton	      NULL		      SG
		 XmCWidget		     Widget
	   _________________________________________________________
	   XmNdefaultButton	      NULL		      SG
		 XmCWidget		     Widget
	   _________________________________________________________
	   XmNdefaultPosition	      True		      CSG
		 XmCDefaultPosition	     Boolean
	   _________________________________________________________
	   XmNdialogStyle	      dynamic		      CSG
		 XmCDialogStyle		     unsigned char
	   _________________________________________________________
	   XmNdialogTitle	      NULL		      CSG
		 XmCDialogTitle		     XmString
	   _________________________________________________________
	   XmNfocusCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________
	   XmNlabelFontList	      dynamic		      CSG
		 XmCLabelFontList	     XmFontList
	   _________________________________________________________
	   XmNmapCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________
	   XmNmarginHeight	      0			      CSG
		 XmCMarginHeight	     Dimension
	   _________________________________________________________
	   XmNmarginWidth	      0			      CSG
		 XmCMarginWidth		     Dimension
	   _________________________________________________________
	   XmNnoResize		      False		      CSG
		 XmCNoResize		     Boolean
	   _________________________________________________________
	   XmNresizePolicy	      XmRESIZE_ANY	      CSG
		 XmCResizePolicy	     unsigned char
	   _________________________________________________________
	   XmNshadowType	      XmSHADOW_OUT	      CSG
		 XmCShadowType		     unsigned char
	   _________________________________________________________
	   XmNtextFontList	      dynamic		      CSG
		 XmCTextFontList	     XmFontList
	   _________________________________________________________
	   XmNtextTranslations	      NULL		      C
		 XmCTranslations	     XtTranslations
	   _________________________________________________________
	   XmNunmapCallback	      NULL		      C
		 XmCCallback		     XtCallbackList
	   _________________________________________________________

			    XXmmMMaannaaggeerr RReessoouurrccee SSeett
	_______________________________________________________________
	NNaammee			      DDeeffaauulltt			 AAcccceessss
	      CCllaassss			    TTyyppee
	_______________________________________________________________
	_______________________________________________________________
	XmNbottomShadowColor	      dynamic			 CSG
	      XmCBottomShadowColor	     Pixel
	_______________________________________________________________
	XmNbottomShadowPixmap	      XmUNSPECIFIED_PIXMAP	 CSG
	      XmCBottomShadowPixmap	     Pixmap
	_______________________________________________________________
	XmNforeground		      dynamic			 CSG
	      XmCForeground		     Pixel
	_______________________________________________________________
	XmNhelpCallback		      NULL			 C
	      XmCCallback		     XtCallbackList
	_______________________________________________________________
	XmNhighlightColor	      dynamic			 CSG
	      XmCHighlightColor		     Pixel
	_______________________________________________________________
	XmNhighlightPixmap	      dynamic			 CSG
	      XmCHighlightPixmap	     Pixmap
	_______________________________________________________________
	XmNinitialFocus		      dynamic			 CSG
	      XmCInitialFocus		     Widget
	_______________________________________________________________
	XmNnavigationType	      XmTAB_GROUP		 CSG
	      XmCNavigationType		     XmNavigationType
	_______________________________________________________________
	XmNshadowThickness	      dynamic			 CSG
	      XmCShadowThickness	     Dimension
	_______________________________________________________________
	XmNstringDirection	      dynamic			 CG
	      XmCStringDirection	     XmStringDirection
	_______________________________________________________________
	XmNtopShadowColor	      dynamic			 CSG
	      XmCTopShadowColor		     Pixel
	_______________________________________________________________
	XmNtopShadowPixmap	      dynamic			 CSG
	      XmCTopShadowPixmap	     Pixmap
	_______________________________________________________________
	XmNtraversalOn		      True			 CSG
	      XmCTraversalOn		     Boolean
	_______________________________________________________________
	XmNunitType		      dynamic			 CSG
	      XmCUnitType		     unsigned char
	_______________________________________________________________
	XmNuserData		      NULL			 CSG
	      XmCUserData		     XtPointer
	_______________________________________________________________

			    CCoommppoossiittee RReessoouurrccee SSeett
	     _____________________________________________________
	     NNaammee		       DDeeffaauulltt		    AAcccceessss
		   CCllaassss		     TTyyppee
	     _____________________________________________________
	     _____________________________________________________
	     XmNchildren	       NULL		    G
		   XmCReadOnly		      WidgetList
	     _____________________________________________________
	     XmNinsertPosition	       NULL		    CSG
		   XmCInsertPosition	      XtOrderProc
	     _____________________________________________________
	     XmNnumChildren	       0		    G
		   XmCReadOnly		      Cardinal
	     _____________________________________________________

			      CCoorree RReessoouurrccee SSeett
     ____________________________________________________________________
     NNaammee				   DDeeffaauulltt		   AAcccceessss
	   CCllaassss				 TTyyppee
     ____________________________________________________________________
     ____________________________________________________________________
     XmNaccelerators			   dynamic		   N/A
	   XmCAccelerators			  XtAccelerators
     ____________________________________________________________________
     XmNancestorSensitive		   dynamic		   G
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNbackground			   dynamic		   CSG
	   XmCBackground			  Pixel
     ____________________________________________________________________
     XmNbackgroundPixmap		   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderColor			   XtDefaultForeground	   CSG
	   XmCBorderColor			  Pixel
     ____________________________________________________________________
     XmNborderPixmap			   XmUNSPECIFIED_PIXMAP	   CSG
	   XmCPixmap				  Pixmap
     ____________________________________________________________________
     XmNborderWidth			   0			   CSG
	   XmCBorderWidth			  Dimension
     ____________________________________________________________________
     XmNcolormap			   dynamic		   CG
	   XmCColormap				  Colormap
     ____________________________________________________________________
     XmNdepth				   dynamic		   CG
	   XmCDepth				  int
     ____________________________________________________________________
     XmNdestroyCallback			   NULL			   C
	   XmCCallback				  XtCallbackList
     ____________________________________________________________________
     XmNheight				   dynamic		   CSG
	   XmCHeight				  Dimension
     ____________________________________________________________________
     XmNinitialResourcesPersistent	   True			   C
	   XmCInitialResourcesPersistent	  Boolean
     ____________________________________________________________________
     XmNmappedWhenManaged		   True			   CSG
	   XmCMappedWhenManaged			  Boolean
     ____________________________________________________________________
     XmNscreen				   dynamic		   CG
	   XmCScreen				  Screen *
     ____________________________________________________________________
     XmNsensitive			   True			   CSG
	   XmCSensitive				  Boolean
     ____________________________________________________________________
     XmNtranslations			   dynamic		   CSG
	   XmCTranslations			  XtTranslations
     ____________________________________________________________________
     XmNwidth				   dynamic		   CSG
	   XmCWidth				  Dimension
     ____________________________________________________________________
     XmNx				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________
     XmNy				   0			   CSG
	   XmCPosition				  Position
     ____________________________________________________________________

  Translations

  XmForm inherits translations from XmBulletinBoard.

RELATED	INFORMATION
  CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmBBuulllleettiinnBBooaarrdd((33XX)),	XXmmCCrreeaatteeFFoorrmm,
  XXmmCCrreeaatteeFFoorrmmDDiiaalloogg((33XX)), and XXmmMMaannaaggeerr((33XX)).


















































