DwtMainWindow(3Dwt) DwtMainWindow(3Dwt)
Name
DwtMainWindow, DwtMainWindowCreate - Creates the main window widget.
Syntax
Widget DwtMainWindow(parent_widget, name, x, y, width, height)
Widget parent_widget;
char *name;
Position x, y;
Dimension width, height;
Widget DwtMainWindowCreate (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. For some applications, the parent widget ID for the main window widget is the ID returned by
XtInitialize. However, the main window widget is not restricted to this type of parent.
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.
width Specifies in pixels the width of the widget window. This argument sets the DwtNwidth core widget attribute.
height Specifies in pixels the height of the widget window. This argument sets the DwtNheight core widget attribute.
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 DwtMainWindow and DwtMainWindowCreate functions create an instance of the main window widget and return its associated widget ID. When
calling DwtMainWindow, you set the main window widget attributes presented in the formal parameter list. For DwtMainWindowCreate, however,
you specify a list of attribute name/value pairs that represent all the possible attributes of the main window widget.
The main window widget can contain a menu bar region, a work area with optional scroll bars, and a command area.
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 5 pixels
DwtNheight Dimension 5 pixels
DwtNborderWidth Dimension One pixel
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 XtTranslations NULL
DwtNmappedWhenManaged Boolean True
DwtNscreen Screen * The parent screen
DwtNdestroyCallback DwtCallbackPtr NULL
Common Attributes
DwtNforeground Pixel Default foreground color
DwtNhighlight NOT SUPPORTED
DwtNhighlightPixmap NOT SUPPORTED
DwtNuserData Opaque * NULL
DwtNdirectionRToL unsigned char DwtDirectionRightDown
DwtNfont NOT SUPPORTED
DwtNhelpCallback DwtCallbackPtr NULL
------------------------------------------------------------------
Widget-Specific Attributes
-----------------------------------------------------------
Attribute Name Data Type Default
-----------------------------------------------------------
DwtNcommandWindow Widget NULL
DwtNworkWindow Widget NULL
DwtNmenuBar Widget NULL
DwtNhorizontalScrollBar Widget NULL
DwtNverticalScrollBar Widget NULL
DwtNacceptFocus Boolean False
DwtNfocusCallback DwtCallbackPtr NULL
-----------------------------------------------------------
DwtNcommandWindow
Specifies the widget ID for the command window to be associated with the main window widget. You can set this ID only after
creating an instance of the main window widget.
DwtNworkWindow Specifies the widget ID for the work window to be associated with the main window widget. You can set this ID only after
creating an instance of the main window widget.
DwtNmenuBar Specifies the widget ID for the menu bar to be associated with the main window widget. You can set this ID only after cre-
ating an instance of the main window widget.
DwtNhorizontalScrollBar
Specifies the scroll bar widget ID for the horizontal scroll bar in the main window widget. You can set this ID only after
creating an instance of the main window widget.
DwtNverticalScrollBar
Specifies the scroll bar widget ID for the vertical scroll bar in the main window widget. You can set this ID only after
creating an instance of the main window widget.
DwtNacceptFocus
Specifies a boolean value that, when False, indicates that the main window widget does not accept the input focus. When the
main window widget is asked to accept the input focus, it attempts to give the input focus first to DwtNworkWindow and then
to DwtNcommandWindow. If neither accepts the input focus and DwtNacceptFocus is True, the main window widget accepts the
input focus.
DwtNfocusCallback
Specifies the callback function or functions called when the main window has accepted the input focus. For this callback,
the reason is DwtCRFocus.
Return Values
These functions return the ID of the created widget.
Callback Information
The following structure is returned to your callback:
typedef struct {
int reason;
XEvent *event;
} DwtAnyCallbackStruct;
The reason member is set to a constant that represents the reason why this callback was invoked. For this callback, the reason member can
be set to:
DwtCRFocus The main window widget
has received the input
focus.
DwtCRHelpRequested The user selected help.
The event member is a pointer to the Xlib structure XEvent, which describes the event that generated this callback. This structure is a
union of the individual structures declared for each event type. For information on XEvent and event processing, see the Guide to the Xlib
Library: C Language Binding.
See Also
Guide to the XUI Toolkit: C Language Binding
Guide to the XUI Toolkit Intrinsics: C Language Binding
DwtMainWindow(3Dwt)