XtAppCreateShell()XtAppCreateShell()NameXtAppCreateShell - create a shell widget at the root of a widget tree.
Synopsis
Widget XtAppCreateShell(application_name, application_class, wid‐
get_class, display, args, num_args)
String application_name;
String application_class;
WidgetClass widget_class;
Display *display;
ArgList args;
Cardinal num_args;
Inputs
application_name
Specifies the resource name of the shell widget, or NULL.
application_class
Specifies the resource class to be used for the shell widget
if it is of applicationShellWidgetClass or a subclass
thereof.
widget_class
Specifies the widget class of the created widget. (normally
applicationShellWidgetClass).
display Specifies the display on which the shell is to be created.
args Specifies the argument list to override other resource speci‐
fications.
num_args Specifies the number of arguments in the argument list.
DescriptionXtAppCreateShell() creates a shell widget of class widget_class on dis‐
play display. The created widget has no parent-it is at the root of a
widget tree and at the top of the resource name hierarchy. The
resource name of the widget is either application_name, or, if that is
NULL, the name that was passed to XtDisplayInitialize() or XtOpenDis‐
play() when the display was initialized. The resource class of the
widget is either application_class, if the widget_class is application‐
ShellWidgetClass or a subclass, or the normal class name of the widget
otherwise. The widget is created on the screen specified by the
XtNscreen resource or on the default screen of display if no such
resource is found.
In X11R4, the XtNscreen and other resources are all obtained from args
and from the database of display. In X11R5, however, there is a
resource database for each screen of a display, and the resources for
the created shell widget are obtained somewhat differently: the argu‐
ment list args is first scanned for a resource named XtNscreen, and if
none is found, the database of the default screen of display is
searched for this resource. If the
XtNscreen resource is found the database from the specified screen is
used for all the remaining resources of the widget. If the XtNscreen
resource is not found, the database of the default screen continues to
be used. In either case, the resources in args override values in the
database.
Usage
Most applications can simply use XtAppInitialize() which initializes
the toolkit, creates an application context, opens a display, and then
calls XtAppCreateShell() to create a shell on that display.
An application that wishes to have multiple toplevel windows on the
same screen (a mail reader and a mail composer, for example) should
generally use XtCreatePopupShell() to create additional shells within
the widget tree and resource hierarchy of the original shell. Creating
multiple root shells with different names is generally not a good idea
because then your application will have resources specified under sev‐
eral different hierarchies. It is sometimes useful to create multiple
root shells with the same name, however, if your application is capable
of creating multiple instances of itself. Each of these instances will
find the same resources in the same database and will appear to be
"clones" of each other.
To create shells on multiple displays, open each display with
XtOpenDisplay() and use the resulting Display * in a call to XtAppCre‐
ateShell(). If all displays are initialized in the same application
context, then all events will be correctly handled by XtAppMainLoop().
XtAppCreateShell() can also be used to create toplevel shells on multi‐
ple screens. Note that prior to X11R5, however, it is not possible to
maintain separate resource databases for each screen.
The specified widget class for the new shell widget should almost
always be applicationShellWidgetClass or some subclass.
XtVaAppCreateShell() behaves identically to XtAppCreateShell(), but
takes a NULL-terminated variable-length argument list of resource
name/resource value pairs rather than an array of Arg.
See AlsoXtAppInitialize(1), XtCreatePopupShell(1), XtDisplayInitialize(1),
XtOpenDisplay(1),
XtVaAppCreateShell(1).
Xt - Initialization XtAppCreateShell()
