XtAppCreateShell(3Xt)      XT FUNCTIONS     XtAppCreateShell(3Xt)


NAME
       XtAppCreateShell - create top-level widget instance

SYNTAX
       Widget XtAppCreateShell(applicationname, applica-
       tionclass, widgetclass, display,
                               args, numargs)
             String applicationname;
             String applicationclass;
             WidgetClass widgetclass;
             Display *display;
             ArgList args;
             Cardinal numargs;

ARGUMENTS
       applicationclass
                 Specifies the class name of this application.

       applicationname
                 Specifies the name of the application instance.

       args      Specifies the argument list in which to set in
                 the WM_COMMAND property.

       display   Specifies the display from which to get the
                 resources.

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

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

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



X Version 11                Release 3                           1