XtAppCreateShell (3)

Leading comments

Copyright (c) 1993, 1994  X Consortium

Permission is hereby granted, free of charge, to any person obtaining a
copy of this software and associated documentation files (the "Software"),
to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense,
and/or sell copies of the Software, and to permit persons to whom the
Software furnished to do so, subject to the following conditions:

The above copyright notice...

(The comments found at the beginning of the groff file "man3/XtAppCreateShell.3".)

NAME

XtAppCreateShell, XtVaAppCreateShell - create top-level widget instance

SYNTAX

Widget XtAppCreateShell(String application_name, String application_class, WidgetClass widget_class, Display *display, ArgList args, Cardinal num_args);

Widget XtVaAppCreateShell(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, which usually is the generic name for all instances 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 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

property set for session managers (see Chapter 4).

SEE ALSO

XtCreateWidget(3)
X Toolkit Intrinsics - C Language Interface
Xlib - C Language X Interface