NAME

XtVaAppCreateShell − create a top-level widget that is the root of a widget tree, using varargs argument style. 

Synopsis

Widget XtVaAppCreateShell(application_name, application_class, widget_class, display, ..., NULL)

    String application_name;
    String application_class;
    WidgetClass widget_class;
    Display *display;

Inputs

application_name
Specifies the resource name of the shell widget.

application_class
Specifies the class name of this application.

widget_class
Specifies the widget class for the top-level widget.

displaySpecifies the display. 

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

Returns

A toplevel shell widget of the specified class. 

Availability

Release 4 and later. 

Description

XtVaAppCreateShell() creates a top-level shell widget that is the root of a widget tree and a resource name hierarchy (i.e. a widget that has no parent).  It is identical to XtAppCreateShell() 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 XtAppCreateShell() for more information on this function.  See XtVaSetValues() for more information on using variable-length argument lists to specify resources. 

Usage

Most applications create secondary top-level shells with XtCreatePopupShell() which creates a widget in the same resource hierarchy as the rest of the application.  Most applications can use XtAppInitialize() or XtVaAppInitialize() to initialize the toolkit and create their first shell. 

See Also

XtAppCreateShell(1), XtAppInitialize(1), XtCreatePopupShell(1), XtVaAppInitialize(1), XtVaSetValues(1). 

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