NAME

XtAppInitialize, XtInitialize − Convenient routine for initializing the X toolkit

SYNTAX

Widget XtAppInitialize(app_context_return,
                       application_class,
                       options, num_options,
                       argc_in_out, argv_in_out,
                       fallback_resources,
                       args_in num_args_in)
      XtAppContext ∗app_context_return;
      String application_class;
      XrmOptionDescRec ∗options;
      Cardinal num_options;
      int ∗argc_in_out;
      String ∗argv_in_out;
      String ∗fallback_resources;
      ArgList args_in;
      Cardinal num_args_in; Widget XtInitialize(application_name, application_class,
                       options, num_options,
                       argc_in_out, argv_in_out)
      String application_name;
      String application_class;
      XrmOptionDescRec ∗options;
      Cardinal num_options;
      int ∗argc_in_out;
      String ∗argv_in_out;

ARGUMENTS

app_context_return
Returns the application context created. Not used. (A left-over for compatibility with the old version.)

application_class
Specifies the class name of the application.

optionsSpecifies how to interpret options on the command line for various application-owned resources.  This options argument is passed as a parameter to XrmParseCommand. For details, see Xlib − C Language X Interface. 

num_optionsSpecifies the number of entries in the list of options. 

argc_in_outThe number of command line arguments. 

argv_in_outPointer to character strings containing the arguments. 

fallback_resources
Specifies the fallback list.

args_inSpecifies the argument list received when the shell widget was created. 

num_args_in
Pointer to the number of arguments in the argument list received when the shell widget was created.

DESCRIPTION

After the XtAppInitialize routine calls the XtToolkitInitialize routine and initializes the toolkit, the XtCreateApplicationContext routine is called to create the application context. After this, the fallback_resource is set and the XtOpenDisplay routine is called to open the display. Then argv_in_out and args_in are merged and the application shell widget is created using the XtAppCreateShell routine and then returned. The XtInitialize routine remains for compatibility with older programs which may need it. The XtInitialize routine merely calls the XtAppInitialize routine and sets the process context to the application context obtained.
If no application context is obtained, the routine must be old-fashioned and defined at a time when no such thing existed. Of the two, the user should use the XtAppInitialize routine.

SEE ALSO

XtToolkitInitialize(3Xt), XtCreateApplicationContext(3Xt), XtOpenDisplay(3Xt), XtAppCreateShell(3Xt)
X Toolkit Intrinsics − C Language Interface
Xlib − C Language X Interface

NEWS-OSRelease 4.2.1R