|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtBuildToplevel(3) | FreeBSD Library Functions Manual | XmtBuildToplevel(3) |
NAME
XmtBuildToplevel(), XmtBuildQueryToplevel() - create a TopLevelShell widget and all of its descendants.SYNOPSIS
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().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.