XtAppCreateShell(3Xt)

NAME
       XtAppCreateShell, XtVaAppCreateShell - create top-level
       widget instance

SYNTAX
       Widget XtAppCreateShell(application_name, applica-
       tion_class, widget_class, display, args, num_args)
             String application_name;
             String application_class;
             WidgetClass widget_class;
             Display *display;
             ArgList args;
             Cardinal num_args;

       Widget XtVaAppCreateShell(application_name, applica-
       tion_class, widget_class, display, ...)
             String application_name;
             String application_class;
             WidgetClass widget_class;
             Display *display;

ARGUMENTS
       application_name
                 Specifies the name of the application instance.

       application_class
                 Specifies the class name of this application.

       widget_class
                 Specifies the widget class that the application
                 top-level widget should be.

       display   Specifies the display from which to get the
                 resources.

       args      Specifies the argument list from which to get
                 the resources.

       num_args  Specifies the number of arguments in the argu-
                 ment list.

       ...       Specifies the variable argument list from which
                 to get the resources.

DESCRIPTION
       The XtAppCreateShell function saves the specified applica-
       tion name and application class for qualifying all widget
       resource specifiers.  The application name and application
       class are used as the left-most components in all widget
       resource names for this application.  XtAppCreateShell
       should be used to create a new logical application within
       a program or to create a shell on another display.  In the
       first case, it allows the specification of a new root in
       the resource hierarchy.  In the second case, it uses the

       resource database associated with the other display.

       Note that the widget returned by XtAppCreateShell has the
       WM_COMMAND property set for session managers (see Chapter
       4).

SEE ALSO
       XtCreateWidget(3Xt) 
       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface