XtAppCreateShell(Xt) X Version 11 (Release 5) XtAppCreateShell(Xt)
6 January 1993
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
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 WMCOMMAND
property.
display Specifies the display from which to get the resources.
numargs Specifies the number of arguments in the argument list.
widgetclass
Specifies the widget class that the application top-level
widget should be.
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 com-
ponents in all widget resource names for this application. XtAppCre-
ateShell should be used to create a new logical application within a pro-
gram 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 dis-
play.
Note that the widget returned by XtAppCreateShell has the WMCOMMAND and
WMCLASS properties set for window and session managers if the specified
widgetclass is a subclass of ApplicationsShell (see Chapter 4 of X
Toolkit Intrinsics - C Language Interface).
See also
XtAppInitialize(Xt) and XtCreateWidget(Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface