NAME

XmtInitialize() - initialize an Xmt application.

SYNOPSIS

#include <Xmt/Xmt.h>

Widget XmtInitialize(XtAppContext *app_context_return, String application_class, XrmOptionDescList options, Cardinal num_options, int *argc_in_out, String *argv_in_out, String *fallback_resources, ArgList args, Cardinal num_args)

ARGUMENTS

INPUTS

application_class: The application class name.
options: An array that describes arguments to be automatically parsed from the command line.
num_options: The number of elements in options.
argc_in_out: The address of the argc argument to main().
argv_in_out: The argv command-line argument to main().
fallback_resources: A NULL-terminated array of resource strings to be used if the application's app-defaults file cannot be located.
args: An array of resource name/value pairs to be set on the returned root ApplicationShell widget.
num_args: The number of elements in args

OUTPUTS

app_context_return: The address at which to return the application's XtAppContext.

RETURNS

A newly created ApplicationShell widget at the root of a widget hierarchy.

DESCRIPTION

XmtInitialize() is a convenience function for initializing Xmt applications. It is a wrapper around XtAppInitialize(), which is the standard Xt initialization function, and has an identical argument list and return value to that function. As part of its initialization sequence, XtAppInitialize() registers standard Xt resource converters, parses standard Xt command-line arguments, and reads standard Xt application resources. XmtInitialize() extends this initialization by registering Xmt resource converters, parsing Xmt-specific command-line arguments and reading Xmt-specific application resources.

After calling XtAppInitialize(), XmtInitialize() calls XmtParseCommandLine() to read Xmt-specific arguments from the command-line, registers all of the major Xmt resource converters, and then calls XmtInitializeApplicationShell() to read the Xmt-specific application resources. See Chapter 8, Application Resources and Command-Line Arguments, for a list of application resource, command-line arguments, and resource converters. See XtAppInitialize() for more details on the arguments to this function.

NAME

SYNOPSIS

ARGUMENTS

DESCRIPTION

SEE ALSO