X Version 11 (Release 5)
XtAppCreateShell(Xt)
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 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).
See also
XtAppInitialize(Xt)
and
XtCreateWidget(Xt)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface
© 2003 X Toolkit Intrinsics (Xt)
SCO OpenServer Release 5.0.7 -- 11 February 2003