NAME

XmtBuildApplication(), XmtBuildQueryApplication() - create a root ApplicationShell 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 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.

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 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.

NAME

SYNOPSIS

ARGUMENTS

DESCRIPTION

USAGE

SEE ALSO