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 XtDisplayInitial‐
ize().
Returns
A toplevel applicationShell widget.
AvailabilityXtInitialize() has been superseded by XtAppInitialize().
DescriptionXtInitialize() is a convenience function for initializing an Xt appli‐
cation. 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.
UsageXtInitialize() has been superseded in Release 4 by XtAppInitialize(),
which is a more general initialization function which supports multiple
application contexts and fallback resources, among other things. There
are a number of Xt functions that have been superseded by "XtApp" ver‐
sions 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 dis‐
plays, 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 AlsoXtAppCreateShell(1), XtAppInitialize(1), XtOpenDisplay(1), XtToolki‐
tInitialize(1).
Xt - Initialization XtInitialize()
