XtAppInitialize(Xt) X Version 11 (Release 5) XtAppInitialize(Xt)
6 January 1993
Name
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
appcontextreturn
Returns the application context, if non-NULL.
applicationclass
Specifies the class name of the application.
options Specifies the command line options table.
numoptions
Specifies the number of entries in options.
argcinout
Specifies a pointer to the number of command line arguments.
argvinout
Specifies a pointer to the command line arguments.
fallbackresources
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.
numargs 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 XtAppInitial-
ize which combines the functions of XtToolkitInitialize, XtCre-
ateApplicationContext, XtDisplayInitialize or XtOpenDisplay, and
XtAppCreateShell.
XtAppInitialize calls XtToolkitInitialize followed by XtCre-
ateApplicationContext, then calls XtOpenDisplay with displaystring NULL
and applicationname NULL, and finally calls XtAppCreateShell with
applicationname NULL, widgetclass applicationShellWidgetClass, and the
specified args and numargs and returns the created shell. The modified
argc and argv returned by XtDiplayInitialize are returned in argcinout
and argvinout. If appcontextreturns is not NULL, the created appli-
cation 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 fallbackresources is non-NULL, XtAppSet-
FallbackResources is called with the value prior to call XtOpenDisplay.
See also
XtAppCreateShell(Xt), XtCreateApplicationContext(Xt) and XtDis-
playInitialize(Xt).
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface