DwtSeparatorGadgetCreate(3Dwt)

Name

DwtSeparatorGadgetCreate − Creates a separator gadget.

Syntax

Widget DwtSeparatorGadgetCreate (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.

nameSpecifies the name of the created 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 DwtSeparatorGadgetCreate function creates an instance of the separator gadget and returns its associated gadget ID. A separator gadget is similar in appearance and semantics to a separator widget. Like all gadgets, DwtSeparatorGadgetCreate does not have a window but uses the window of the closest antecedent widget. Thus, the antecedent widget provides all event dispatching for the gadget. This currently restricts gadgets to being descendents of menu or dialog class (or subclass) widgets.

Inherited Attributes

Attribute Name	Data Type	Default
Rectangle Attributes
DwtNx	Position	Determined by the geometry manager
DwtNy	Position	Determined by the geometry manager
DwtNwidth	Dimension	3 pixels
DwtNheight	Dimension	3 pixels
DwtNborderWidth	Dimension	zero
DwtNsensitive	Boolean	True
DwtNancestorSensitive	Boolean	The bitwise AND of the parent widget’s DwtNsensitive and DwtNancestorSensitive attributes

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 DwtOrientationVertical. A separator gadget 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 gadget.

Return Values

This function returns the ID of the created widget.

Callback Information

There is no callback for this gadget.

Museum