DwtSeparatorGadgetCreate(3Dwt) 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.
name Specifies 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 DwtNances-
torSensitive
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 DwtOrien-
tationVertical. A separator gadget 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 gadget.
Return Values
This function returns the ID of the created widget.
Callback Information
There is no callback for this gadget.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtSeparatorGadgetCreate(3Dwt)