XtAppCreateShell(3Xt)RISC/os Reference ManuaXtAppCreateShell(3Xt)



NAME
     XtAppCreateShell - create top-level widget instance

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

ARGUMENTS
     application_class
               Specifies the class name of this application.

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

     num_args  Specifies the number of arguments in the argument
               list.

     widget_class
               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)



                         Printed 1/24/91  1 September 1988 Page 1

XtAppCreateShell(3Xt)RISC/os Reference ManuaXtAppCreateShell(3Xt)



     X Toolkit Intrinsics - C Language Interface
     Xlib - C Language X Interface





















































1 September 1988 Page 2  Printed 1/24/91