Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

dwtmainwindowcreate(3dwt) [ultrix man page]

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)
Man Page