FreeBSD Manual Pages
XmtBuildApplication(3) Library Functions Manual XmtBuildApplication(3) NAME XmtBuildApplication(), XmtBuildQueryApplication() - create a root Ap- plicationShell widget and all of its descendants. SYNOPSIS #include <Xmt/Create.h> 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 cre- ated. 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 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 root ApplicationShell widget. DESCRIPTION XmtBuildApplication() and XmtBuildQueryApplication() create a root ApplicationShell widget by calling XtAppCreateShell(), with their app- name, 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 XmtCreat- eChildren() and XmtCreateQueryChildren() do. Like XmtCreateQueryChil- dren(), XmtBuildQueryApplication() can return pointers to some of the widgets it creates. USAGE Most applications will only have a single root Application Shell wid- get, created by their call to XtAppInitialize() or XmtInitialize(). Applications that do create additional root widgets may use these func- tions 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(). Xmt Motif Tools XmtBuildApplication(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=XmtBuildQueryApplication&sektion=3&manpath=FreeBSD+Ports+15.0>