XmtBuildToplevel(3) FreeBSD 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
argument 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
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.
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)
permalink to the XmtBuildToplevel command:
https://manpage.me/?XmtBuildToplevel
link by Name, Section, and OS version of this man page:
/?q=XmtBuildToplevel&manpath=FreeBSD+11.1-RELEASE+and+Ports