Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

XtAppInitialize(1)

XtVaSetValues(1)

NAME

XtVaAppInitialize − initialize the X Toolkit internals, using varargs argument style. 

Synopsis

Widget XtVaAppInitialize(app_context_return, application_class, options, num_options, argc_in_out, argv_in_out, fallback_resources, ..., NULL)

    XtAppContext *app_context_return;
    String application_class;
    XrmOptionDescList options;
    Cardinal num_options;
    int *argc_in_out;     /* was type Cardinal * in Release 4 */
    String *argv_in_out;
    String *fallback_resources;

Inputs

app_context_return
Returns the application context, if non-NULL. 

application_class
Specifies the class name of the application.

optionsSpecifies the command line options table. 

num_optionsSpecifies the number of entries in options. 

argc_in_outSpecifies a pointer to the number of command line arguments.  This argument was a Cardinal * in Release 4, and is an int * in Release 5. 

argv_in_outSpecifies the command line arguments array. 

fallback_resources
Specifies resource values to be used if the application class resource file cannot be opened, or NULL. 

..., NULLA NULL-terminated variable-length list of resource name/value pairs to override any other resource specifications for the created shell. 

Returns

A toplevel shell widget of class applicationShellWidgetClass. 

Availability

Release 4 and later. 

Description

XtVaAppInitialize() initializes the Toolkit internals, creates an application context, opens and initializes a display, and creates the initial application shell.  It is identical to XtAppInitialize() except that the args array of resource names and values and the num_args argument of that function are replaced with a NULL-terminated variable-length argument list.  See XtAppInitialize() for more information on this function.  See XtVaSetValues() for more information on using variable-length argument lists to specify resources. 

See Also

XtAppInitialize(1), XtVaSetValues(1). 

Copyright O’Reilly & Assoc.  —  X Toolkit Intrinsics Reference Manual © O’Reilly & Associates

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026