


XmSeparatorGadget(3X)					XmSeparatorGadget(3X)
OSF/Motif							    OSF/Motif



NAME
  XXmmSSeeppaarraattoorrGGaaddggeett - The SeparatorGadget widget class

SYNOPSIS


  ##iinncclluuddee <<XXmm//SSeeppaarraattooGG..hh>>

DESCRIPTION
  SeparatorGadget separates items in a display.	 Several line drawing styles
  are provided,	as well	as horizontal or vertical orientation.

  Lines	drawn within the SeparatorGadget are automatically centered within
  the height of	the gadget for a horizontal orientation	and centered within
  the width of the gadget for a	vertical orientation.  An XXttSSeettVVaalluueess with a
  new XXmmNNsseeppaarraattoorrTTyyppee resizes the widget to its minimal height	(for horizon-
  tal orientation) or its minimal width	(for vertical orientation) unless
  height or width is explicitly	set in the XXttSSeettVVaalluueess call.

  SeparatorGadget does not draw	shadows	around the separator.  The Gadget
  resource XXmmNNsshhaaddoowwTThhiicckknneessss is used for the SeparatorGadget's	thickness
  when XXmmNNsseeppaarraattoorrTTyyppee	is XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN, XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN__DDAASSHH,
  XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT, or XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT__DDAASSHH.

  SeparatorGadget does not highlight and allows	no traversing.	The Gadget
  resource XXmmNNttrraavveerrssaallOOnn is forced to False.

  Classes

  SeparatorGadget inherits behavior and	resources from OObbjjeecctt, RReeccttOObbjj,	and
  XXmmGGaaddggeett Classes.

  The class pointer is xxmmSSeeppaarraattoorrGGaaddggeettCCllaassss.

  The class name is XXmmSSeeppaarraattoorrGGaaddggeett.

  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mSSeeppaarraattoorrGGaaddggeet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
	    ______________________________________________________
	    ______________________________________________________
	    XmNmargin		     0			    CSG
		  XmCMargin		    Dimension
	    ______________________________________________________
	    XmNorientation	     XmHORIZONTAL	    CSG
		  XmCOrientation	    unsigned char
	    ______________________________________________________
	    XmNseparatorType	     XmSHADOW_ETCHED_IN	    CSG
		  XmCSeparatorType	    unsigned char
	    ______________________________________________________

  XXmmNNmmaarrggiinn For	horizontal orientation,	specifies the space on the left	and
	    right sides	between	the border of SeparatorGadget and the line
	    drawn.  For	vertical orientation, specifies	the space on the top
	    and	bottom between the border of SeparatorGadget and the line
	    drawn.

  XXmmNNoorriieennttaattiioonn
	    Specifies whether SeparatorGadget is displayed vertically or hor-
	    izontally.	This resource can have values of XXmmVVEERRTTIICCAALL and
	    XXmmHHOORRIIZZOONNTTAALL.

  XXmmNNsseeppaarraattoorrTTyyppee
	    Specifies the type of line drawing to be done in the Separator
	    widget.

	      oo++
	      XXmmSSIINNGGLLEE__LLIINNEE-single line.

	      oo++
	      XXmmDDOOUUBBLLEE__LLIINNEE-double line.

	      oo++
	      XXmmSSIINNGGLLEE__DDAASSHHEEDD__LLIINNEE-single-dashed line.

	      oo++
	      XXmmDDOOUUBBLLEE__DDAASSHHEEDD__LLIINNEE-double-dashed line.

	      oo++
	      XXmmNNOO__LLIINNEE-no line.

	      oo++
	      XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN-a line	whose shadows give the effect of a
	      line etched into the window.  The	thickness of the line is
	      equal to the value of XXmmNNsshhaaddoowwTThhiicckknneessss.	 For horizontal
	      orientation, the top shadow is drawn in XXmmNNttooppSShhaaddoowwCCoolloorr	and
	      the bottom shadow	is drawn in XXmmNNbboottttoommSShhaaddoowwCCoolloorr.  For verti-
	      cal orientation, the left	edge is	drawn in XXmmNNttooppSShhaaddoowwCCoolloorr
	      and the right edge is drawn in XXmmNNbboottttoommSShhaaddoowwCCoolloorr.

	      oo++
	      XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT-a line whose shadows give the	effect of an
	      etched line coming out of	the window.  The thickness of the
	      line is equal to the value of XXmmNNsshhaaddoowwTThhiicckknneessss.	 For horizon-
	      tal orientation, the top shadow is drawn in XXmmNNbboottttoommSShhaa--
	      ddoowwCCoolloorr and the bottom shadow is	drawn in XXmmNNttooppSShhaaddoowwCCoolloorr.
	      For vertical orientation,	the left edge is drawn in XXmmNNbboott--
	      ttoommSShhaaddoowwCCoolloorr and the right edge	is drawn in XXmmNNttooppSShhaa--
	      ddoowwCCoolloorr.

	      oo++
	      XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN__DDAASSHH-identical	to XXmmSSHHAADDOOWW__EETTCCHHEEDD__IINN except
	      a	series of lines	creates	a dashed line.

	      oo++
	      XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT__DDAASSHH-identical to XXmmSSHHAADDOOWW__EETTCCHHEEDD__OOUUTT
	      except a series of lines creates a dashed	line.



  Inherited Resources

  SeparatorGadget inherits behavior and	resources from the following superc-
  lasses.  For a complete description of each resource,	refer to the man page
  for that superclass.

			    XXmmGGaaddggeet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
	______________________________________________________________
	______________________________________________________________
	XmNbottomShadowColor	      dynamic			G
	      XmCBottomShadowColor	     Pixel
	______________________________________________________________
	XmNhelpCallback		      NULL			C
	      XmCCallback		     XtCallbackList
	______________________________________________________________
	XmNhighlightColor	      dynamic			G
	      XmCHighlightColor		     Pixel
	______________________________________________________________
	XmNhighlightOnEnter	      False			CSG
	      XmCHighlightOnEnter	     Boolean
	______________________________________________________________
	XmNhighlightThickness	      0				CSG
	      XmCHighlightThickness	     Dimension
	______________________________________________________________
	XmNnavigationType	      XmNONE			CSG
	      XmCNavigationType		     XmNavigationType
	______________________________________________________________
	XmNshadowThickness	      2				CSG
	      XmCShadowThickness	     Dimension
	______________________________________________________________
	XmNtopShadowColor	      dynamic			G
	      XmCTopShadowColor		     Pixel
	______________________________________________________________
	XmNtraversalOn		      False			G
	      XmCTraversalOn		     Boolean
	______________________________________________________________
	XmNunitType		      dynamic			CSG
	      XmCUnitType		     unsigned char
	______________________________________________________________
	XmNuserData		      NULL			CSG
	      XmCUserData		     XtPointer
	______________________________________________________________

			     RReeccttOObbjj 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
	       ________________________________________________
	       ________________________________________________
	       XmNancestorSensitive   dynamic		 G
		     XmCSensitive	     Boolean
	       ________________________________________________
	       XmNborderWidth	      0			 CSG
		     XmCBorderWidth	     Dimension
	       ________________________________________________
	       XmNheight	      dynamic		 CSG
		     XmCHeight		     Dimension
	       ________________________________________________
	       XmNsensitive	      True		 CSG
		     XmCSensitive	     Boolean
	       ________________________________________________
	       XmNwidth		      dynamic		 CSG
		     XmCWidth		     Dimension
	       ________________________________________________
	       XmNx		      0			 CSG
		     XmCPosition	     Position
	       ________________________________________________
	       XmNy		      0			 CSG
		     XmCPosition	     Position
	       ________________________________________________

			      OObbjjeecct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
	      ___________________________________________________
	      ___________________________________________________
	      XmNdestroyCallback   NULL			   C
		    XmCCallback		  XtCallbackList
	      ___________________________________________________

  Behavior

  XmSeparatorGadget has	no behavior.

RELATED	INFORMATION
  OObbjjeecctt((33XX)), RReeccttOObbjj((33XX)), XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett((33XX)),	XXmmGGaaddggeett((33XX))










































