GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  XMTBUILDTOPLEVEL (3)

NAME

XmtBuildToplevel(), XmtBuildQueryToplevel() - create a TopLevelShell widget and all of its descendants.

CONTENTS

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().
Search for    or go to Top of page |  Section 3 |  Main Index


Xmt XMTBUILDTOPLEVEL (3) Motif Tools

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.