X Version 11 (Release 6.1)

XtAppCreateShell(X3xt)


XtAppCreateShell -- create top-level widget instance

Synopsis

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;

Widget XtVaAppCreateShell(application_name, application_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 in which to set in the WM_COMMAND property.

num_args
Specifies the number of arguments in the argument list.

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

Description

The XtAppCreateShell function saves the specified application 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 and WM_CLASS properties set for window and session managers if the specified widget_class is a subclass of ApplicationsShell (see Chapter 4 of X Toolkit Intrinsics - C Language Interface).

References

XtAppInitialize(X3xt), XtCreateWidget(X3xt)

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


© 2004 The SCO Group, Inc. All rights reserved.
UnixWare 7 Release 7.1.4 - 25 April 2004