XtInitialize() XtInitialize()
Name
XtInitialize - initialize toolkit and display.
Synopsis
Widget XtInitialize(shell_name, application_class, options, num_options, argc, argv)
String shell_name; /* unused */
String application_class;
XrmOptionDescRec options[];
Cardinal num_options;
Cardinal *argc;
char *argv[];
Inputs
shell_name
This parameter is ignored; you can specify NULL.
application_class
Specifies the class name of this application.
options Specifies how to parse the command line for any application-specific resources. The options argument is passed as a parameter to
XtDisplayInitialize().
num_options
Specifies the number of entries in options list.
argc Specifies a pointer to the number of command line parameters.
argv Specifies the command line parameters.
Outputs
argc Returns the number of command line arguments remaining after the command line is parsed with XtDisplayInitialize()
argv Returns the command line as modified by XtDisplayInitialize().
Returns
A toplevel applicationShell widget.
Availability
XtInitialize() has been superseded by XtAppInitialize().
Description
XtInitialize() is a convenience function for initializing an Xt application. It calls XtToolkitInitialize() to initialize the toolkit
internals, creates a default application context for use by other superseded functions, calls XtOpenDisplay() with display_string NULL and
application_name NULL, and finally calls XtAppCreateShell() with application_name NULL and returns the created shell. The semantics of
calling XtInitialize() more than once are undefined.
Usage
XtInitialize() has been superseded in Release 4 by XtAppInitialize(), which is a more general initialization function which supports multi-
ple application contexts and fallback resources, among other things. There are a number of Xt functions that have been superseded by
"XtApp" versions that take an application context as an argument. If you want to use these superseded functions, you must initialize your
application with XtInitialize() which creates the default application context that these functions all use.
If you do not want to use multiple application contexts, multiple displays, or fallback resources, you can continue to use XtInitialize().
We recommend, however, that you use XtAppInitialize() and the other XtApp*() application context specific functions.
See XtAppInitialize() for more information.
See Also
XtAppCreateShell(1), XtAppInitialize(1), XtOpenDisplay(1), XtToolkitInitialize(1).
Xt - Initialization XtInitialize()
