Query: dwtmainwindow
OS: ultrix
Section: 3dwt
Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar
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)