FreeBSD Manual Pages
XmtBuildToplevel(3) Library Functions Manual XmtBuildToplevel(3) NAME XmtBuildToplevel(), XmtBuildQueryToplevel() - create a TopLevelShell widget and all of its descendants. SYNOPSIS #include <Xmt/Create.h> Widget XmtBuildToplevel(Widget parent, String name) Widget XmtBuildQueryToplevel(Widget parent, String name, { String child_name, Widget *child_address, } NULL) ARGUMENTS INPUTS 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 argu- ment list. OUTPUTS 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. RETURNS The newly created TopLevelShell widget. DESCRIPTION XmtBuildToplevel() and XmtBuildQueryToplevel() call XtCreatePopup- Shell() 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 argu- ment list. USAGE 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. SEE ALSO Chapter 11, Automatic Widget Creation, XmtBuildApplication(), XmtBuildDialog(), XmtCreateChildren(), XmtCreateQueryChildren(), XtCreatePopupShell(), XtPopdown(), XtPopup(). Xmt Motif Tools XmtBuildToplevel(3)
NAME | SYNOPSIS | ARGUMENTS | DESCRIPTION | USAGE | SEE ALSO
Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=XmtBuildToplevel&sektion=3&manpath=FreeBSD+Ports+15.0>