DwtSeparator(3Dwt)														DwtSeparator(3Dwt)

Name
       DwtSeparator, DwtSeparatorCreate - Creates a separator widget for the application to define a border between items in a display.

Syntax
       Widget DwtSeparator(parent_widget, name, x, y, orientation)
	    Widget parent_widget;
	    char *name;
	    Position x, y;
	    unsigned char orientation;

       Widget DwtSeparatorCreate (parent_widget, name,
				  override_arglist, override_argcount)
	    Widget parent_widget;
	    char *name;
	    ArgList override_arglist;
	    int override_argcount;

Arguments
       parent_widget
		 Specifies the parent widget ID.

       name	 Specifies the name of the created widget.

       x	 Specifies  the  placement, in pixels, of the left side of the widget window relative to the inner upper left corner of the parent
		 window.  This argument sets the DwtNx core widget attribute.

       y	 Specifies, in pixels, the placement of the upper left corner of the widget window relative to the inner upper left corner of  the
		 parent window.  This argument sets the DwtNy core widget attribute.

       orientation
		 Specifies  whether  the  separator is displayed vertically or horizontally.  You can pass DwtOrientationHorizontal or DwtOrienta-
		 tionVertical.	This argument sets the DwtNorientation attribute associated with DwtSeparatorCreate.

		 A separator widget draws a centered single pixel line between the appropriate margins.  For example, a horizontal separator draws
		 a horizontal line from the left margin to the right margin.  It is placed vertically in the middle of the widget.

       override_arglist
		 Specifies the application override argument list.

       override_argcount
		 Specifies the number of attributes in the application override argument list (override_arglist).

Description
       The  DwtSeparator  and  DwtSeparatorCreate  functions create an instance of the separator widget and return its associated widget ID.  When
       calling DwtSeparator, you set the widget attributes presented in the formal parameter list.  For DwtSeparatorCreate, however, you specify a
       list of attribute name/value pairs that represent all the possible separator widget attributes.

       The  separator  widget is a screen object that allows the application to draw a separator between items in a display.  The separator widget
       draws horizontal or vertical lines in inactive areas of a window (typically menus).  Because a separator widget does not support  children,
       it always refuses geometry requests.  The separator widget does nothing on a resize by its parents.

Inherited Attributes
       ------------------------------------------------------------------
       Attribute Name	       Data Type	Default
       ------------------------------------------------------------------
       Core Attributes

       DwtNx		       Position 	Determined by the geome-
						try manager
       DwtNy		       Position 	Determined by the geome-
						try manager

       DwtNwidth	       Dimension	3 pixels
       DwtNheight	       Dimension	3 pixels
       DwtNborderWidth	       int		zero
       DwtNborder	       Pixel		Default foreground color
       DwtNborderPixmap        Pixmap		NULL
       DwtNbackground	       Pixel		Default background color
       DwtNbackgroundPixmap    Pixmap		NULL
       DwtNcolormap	       Colormap 	Default color map
       DwtNsensitive	       Boolean		True
       DwtNancestorSensitive   Boolean		The  bitwise  AND of the
						parent widget's DwtNsen-
						sitive	 and  DwtNances-
						torSensitive attributes
       DwtNaccelerators        XtTranslations	NULL
       DwtNdepth	       int		Depth of the parent win-
						dow
       DwtNtranslations        NOT SUPPORTED
       DwtNmappedWhenManaged   Boolean		True
       DwtNscreen	       Screen * 	The parent screen
       DwtNdestroyCallback     DwtCallbackPtr	NULL

       Common Attributes

       DwtNforeground	       Pixel		Default foreground color
       DwtNhighlight	       Pixel		Default foreground color
       DwtNhighlightPixmap     Pixmap		NULL
       DwtNuserData	       Opaque * 	NULL
       DwtNdirectionRToL       unsigned char	DwtDirectionRightDown
       DwtNfont 	       NOT SUPPORTED
       DwtNhelpCallback        NOT SUPPORTED

       Label Attributes

       DwtNlabelType	       unsigned char	DwtCString
       DwtNlabel	       DwtCompString	Widget name
       DwtNmarginWidth	       Dimension	Two pixels for text
						Zero pixels for pixmap
       DwtNmarginHeight        Dimension	Two pixels for text
						Zero pixels for pixmap
       DwtNalignment	       unsigned char	DwtAlignmentCenter
       DwtNpixmap	       Pixmap		NULL
       DwtNmarginLeft	       Dimension	Zero
       DwtNmarginRight	       Dimension	Zero
       DwtNmarginTop	       Dimension	Zero
       DwtNmarginBottom        Dimension	Zero
       DwtNconformToText       Boolean		True,  if  the widget is
						created with a width and
						height of zero
						False,	if the widget is
						created with a	non-zero
						width and height
       ------------------------------------------------------------------

Widget-Specific Attributes
       ------------------------------------------------------------
       Attribute Name	 Data Type	 Default
       ------------------------------------------------------------
       DwtNorientation	 unsigned char	 DwtOrientationHorizontal
       ------------------------------------------------------------

       DwtNorientation
		      Specifies whether the separator is displayed vertically or horizontally.	You can pass DwtOrientationHorizontal or DwtOrien-
		      tationVertical.  A separator widget draws a centered single pixel line between the appropriate margins.  For example, a hor-
		      izontal  separator  draws a horizontal line from the left margin to the right margin.  It is placed vertically in the middle
		      of the widget.

Return Values
       These functions return the ID of the created widget.

See Also
       Guide to the XUI Toolkit: C Language Binding
       Guide to the XUI Toolkit Intrinsics: C Language Binding

																DwtSeparator(3Dwt)