xmMainWindow

xmMainWindow

This composite widget is used for the application's main window. As you add children to it (xmMenuBar, xmList, xmMessageBox, a work area, and so forth) it manages them, as you could do manually with xmForm.

The management of the work area is not immediate: the main window must know which of its children is the work area before you can manage that widget. The following example produces a prototype interface for a standard application:

#! /usr/sgitcl/bin/moat 
xtAppInitialize
xmMainWindow .top -showSeparator True \
        -commandWindowLocation command_below_workspace
xmMenuBar .top.bar managed
xmCascadeButton .top.bar.File managed 
xmCascadeButton .top.bar.Help managed
xmDrawingArea .top.work \
        -width 320 -height 240 \
        -background black
.top setValues -workWindow .top.work
.top.work manageChild
xmCommand .top.com managed \
        -historyVisibleItemCount 0 \
        -textFontList  -*-courier-medium-r-*--12-*-*-*-*-*-*
.top.com commandEnteredCallback {%value}
.top setValues -width 600 -height 500
.top manageChild
. realizeWidget
. mainLoop

The xmMainWindow widget defines these resources, renaming resources of the parents, as shown in Table 4-50.

xmMainWindow Resources
Resource Name Default Value Type or Legal Values
-commandWindow none Widget
-commandWindowLocation above command_above_workspace
command_below_workspace
-mainWindowMarginHeight 0 Dimension
-mainWindowMarginWidth 0 Dimension
-menuBar none Widget
-messageWindow none Widget
-showSeparator False Boolean

xmMainWindow Resources
Resource Name	Default Value	Type or Legal Values
-commandWindow	none	Widget
-commandWindowLocation	above	command_above_workspace command_below_workspace
-mainWindowMarginHeight	0	Dimension
-mainWindowMarginWidth	0	Dimension
-menuBar	none	Widget
-messageWindow	none	Widget
-showSeparator	False	Boolean

Table 4-51 lists the callbacks associated with xmMainWindow.

xmMainWindow Callbacks
Method Name Why
commandChangedCallback You typed some new text, recalled a history item, etc.
commandEnteredCallback You typed <Enter>, double-clicked the mouse, etc.
focusCallback The window gained input focus.
mapCallback The window was mapped on screen.
unmapCallback The window was unmapped.

xmMainWindow Callbacks
Method Name	Why
commandChangedCallback	You typed some new text, recalled a history item, etc.
commandEnteredCallback	You typed <Enter>, double-clicked the mouse, etc.
focusCallback	The window gained input focus.
mapCallback	The window was mapped on screen.
unmapCallback	The window was unmapped.