|
Unix VPS
Support
FAQ
Network
Miscellaneous
|
| XmtBuildApplication(3) | FreeBSD Library Functions Manual | XmtBuildApplication(3) |
NAME
XmtBuildApplication(), XmtBuildQueryApplication() - create a root ApplicationShell widget and all of its descendants.SYNOPSIS
Widget XmtBuildApplication(String appname, String appclass, Display *display, ArgList args, Cardinal num_args)
Widget XmtBuildQueryApplication(String
appname, String appclass, Display
*display, ArgList args, Cardinal
num_args,
{ String child_name, Widget *child_address,
}
NULL)
ARGUMENTS
INPUTS- appname
- The name of the root application shell to be created.
- appclass
- The resource class name of the root application shell to be created.
- display
- The X Display on which the application shell is to be created.
- args
- An array of name/value pairs of resources to be set on the newly created application shell.
- num_args
- The number of elements in args.
- 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 newly created root ApplicationShell widget.
DESCRIPTION
XmtBuildApplication() and XmtBuildQueryApplication() create a root ApplicationShell widget by calling XtAppCreateShell(), with their appname, appclass, display, args and num_args arguments. 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(), XmtBuildQueryApplication() can return pointers to some of the widgets it creates.USAGE
Most applications will only have a single root Application Shell widget, created by their call to XtAppInitialize() or XmtInitialize(). Applications that do create additional root widgets may use these functions to create those shells and their descendants.Use XmtBuildToplevel() and XmtBuildDialog() to create Top LevelShell widgets and dialog boxes in a similar way.
SEE ALSO
Chapter 11, Automatic Widget Creation,XmtBuildDialog(), XmtBuildToplevel(), XmtCreateChildren(), XmtCreateQueryChildren(), XmtInitialize(), XtAppCreateShell(), XtAppInitialize().
| Motif Tools | Xmt |
Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.