NAME

XtAppInitialize − initialize X Toolkit internals, create an application context, open and initialize a display, and create the initial application shell instance. 

SYNTAX

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;
    Cardinal *argc_in_out;
    String *argv_in_out;
    String *fallback_resources;
    ArgList args;
    Cardinal num_args;

ARGUMENTS

app_contextIf non-NULL, returns the application context. 

app_classSpecifies the class name of the application. 

optionsSpecifies the command line options table. 

num_optionsSpecifies the number of entries in options list. 

argc
Specifies the number of command line arguments.

argvSpecifies a list of command line arguments. 

fallbacksSpecifies a null-terminated list of resource specifications, or NULL. 

args
Specifies an argument list used to override default values.

num_args
Specifies the number of entries in the argument list.

DESCRIPTION

The XtAppInitialize function performs the following operations:

•Initializes the X Tookkit Intrinsics library by calling XtToolkitinitialize.

•Creates an application context by calling XtCreateApplicationContext.

•Creates a set of fallback resources by calling XtAppSetFallbackResources with fallbacks if it in non-NULL. 

•Opens and initializes a display by calling XtOpenDisplay with a display_name of NULL and an application_name of NULL. 

•Calls XtAppCreateShell with an application_name of NULL, a widget_class of applicationShellWidgetClass, and the specified args and num_args. 

The XtAppInitialize function returns the ID of the newly created shell widget. The modified values returned by XtOpenDisplay for argc and argv are returned to the caller.  If app_context is not NULL, the application context created by XtCreateApplicationContext is also returned. If the display specified by the command line cannot be opened, an error message is issued and the application is terminated.

SEE ALSO

XtAppCreateShell(3Xt) and XtCreateApplicationContext(3Xt).

X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface