XtInitialiA(3x) — HP-UX ANSI C A.10.11

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.

optionsSpecifies 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.

argcSpecifies a pointer to the number of command line parameters.

argvSpecifies the command line parameters.

Outputs

argcReturns the number of command line arguments remaining after the command line is parsed with XtDisplayInitialize()

argvReturns 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 multiple 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.

Museum

Related Articles