XtAppCreateShell(3Xt) XT FUNCTIONS 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
X Version 11 Release 6.4 1
XtAppCreateShell(3Xt) XT FUNCTIONS XtAppCreateShell(3Xt)
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 ALSOXtCreateWidget(3Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
X Version 11 Release 6.4 2