xtvaappcreateshell(3) [hpux man page]
XtVaAppCreateShell() XtVaAppCreateShell() Name XtVaAppCreateShell - create a top-level widget that is the root of a widget tree, using varargs argument style. Synopsis Widget XtVaAppCreateShell(application_name, application_class, widget_class, display, ..., NULL) String application_name; String application_class; WidgetClass widget_class; Display *display; Inputs application_name Specifies the resource name of the shell widget. application_class Specifies the class name of this application. widget_class Specifies the widget class for the top-level widget. display Specifies the display. ..., NULL A NULL-terminated variable-length list of resource name/value pairs to override any other resource specifications. Returns A toplevel shell widget of the specified class. Availability Release 4 and later. Description XtVaAppCreateShell() creates a top-level shell widget that is the root of a widget tree and a resource name hierarchy (i.e. a widget that has no parent). It is identical to XtAppCreateShell() except that the args array of resource names and values and the num_args argument of that function are replaced with a NULL-terminated variable-length argument list. See XtAppCreateShell() for more information on this function. See XtVaSetValues() for more information on using variable-length argument lists to specify resources. Usage Most applications create secondary top-level shells with XtCreatePopupShell() which creates a widget in the same resource hierarchy as the rest of the application. Most applications can use XtAppInitialize() or XtVaAppInitialize() to initialize the toolkit and create their first shell. See Also XtAppCreateShell(1), XtAppInitialize(1), XtCreatePopupShell(1), XtVaAppInitialize(1), XtVaSetValues(1). Xt - Initialization XtVaAppCreateShell()
Check Out this Related Man Page
XtAppCreateShell(3Xt) XT FUNCTIONS XtAppCreateShell(3Xt) NAME
XtAppCreateShell, XtVaAppCreateShell - 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; Widget XtVaAppCreateShell(application_name, application_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 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. XtApp- CreateShell 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 property set for session managers (see Chapter 4). SEE ALSO
XtCreateWidget(3Xt) X Toolkit Intrinsics - C Language Interface Xlib - C Language X Interface X Version 11 Release 6.6 XtAppCreateShell(3Xt)