X Version 11 (Release 5)
XtAppInitialize(Xt)
XtAppInitialize --
initialize application convenience procedure
Syntax
Widget XtAppInitialize(app_context_return, application_class, options,
num_options, argc_in_out, argv_in_out, fallback_resources, args,
num_args)
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
app_context_return-
Returns the application context, if non-NULL.
application_class-
Specifies the class name of the application.
options-
Specifies the command line options table.
num_options-
Specifies the number of entries in options.
argc_in_out-
Specifies a pointer to the number of command line arguments.
argv_in_out-
Specifies a pointer to the command line arguments.
fallback_resources-
Specifies resource values to be used if the application class
resource file cannot be opened or read, or NULL.
args-
Specifies the argument list to override any other resource
specifications for the created shell widget.
num_args-
Specifies the number of entries in the argument list.
Description
To initialize the Intrinsics internals, create an application context,
open and initialize a display, and create the initial
application shell instance, an application may use the convenience procedure
XtAppInitialize which combines the functions of
XtToolkitInitialize,
XtCreateApplicationContext,
XtDisplayInitialize or XtOpenDisplay,
and
XtAppCreateShell.
XtAppInitialize calls
XtToolkitInitialize
followed by
XtCreateApplicationContext, then calls
XtOpenDisplay with display_string NULL and
application_name NULL, and finally calls
XtAppCreateShell with application_name NULL,
widget_class applicationShellWidgetClass, and
the specified args and num_args and returns
the created shell. The modified argc and argv
returned by XtDiplayInitialize are returned in
argc_in_out and argv_in_out.
If app_context_returns is not NULL, the created
application context is also returned.
If the display specified by the command line cannot be
opened, and error message is issued and XtAppInitialize
terminates the application.
If fallback_resources is non-NULL,
XtAppSetFallbackResources is called with the
value prior to call XtOpenDisplay.
See also
XtAppCreateShell(Xt),
XtCreateApplicationContext(Xt)
and
XtDisplayInitialize(Xt).
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
© 2003 X Toolkit Intrinsics (Xt)
SCO OpenServer Release 5.0.7 -- 11 February 2003