|parent||The parent of the shell to be created.|
|name||The name of the shell to be created.|
|child_name||The name of a widget to be returned. May be repeated any number of times in a NULL-terminated variable-length argument list.|
child_address The address at which the widget specified by child_name is to be stored. May be repeated any number of times in a NULL-terminated variable length argument list.
The newly created TopLevelShell widget.
XmtBuildToplevel() and XmtBuildQueryToplevel() call XtCreatePopupShell() to create a TopLevelShell with the specified parent and name. Then they read the xmtChildren resource of the newly created shell and recursively create all the descendants of the shell, in the same way that XmtCreateChildren() and XmtCreateQueryChildren() do.
Like XmtCreateQueryChildren(), XmtBuildQueryToplevel() can return some of the widgets it creates. If any of the created widgets has a name that appears as a child_name argument, then that widget is returned in the corresponding child_address argument in the variable-length argument list.
The TopLevelShell widget is useful for auxiliary windows of your application. These windows are unlike dialog boxes in that they can be iconified independently of the application itself. Note that unlike Motif dialogs implemented with the XmDialogShell widget, TopLevelShell widgets must be popped up and down with XtPopup() and XtPopdown().
Use XmtBuildDialog() to create dialog boxes in a similar way.
Chapter 11, Automatic Widget Creation,
XmtBuildApplication(), XmtBuildDialog(), XmtCreateChildren(), XmtCreateQueryChildren(), XtCreatePopupShell(), XtPopdown(), XtPopup().
|Xmt||XMTBUILDTOPLEVEL (3)||Motif Tools|