xtcreateapb(3) [hpux man page]

XtCreateApplicationShell()												XtCreateApplicationShell()

Name
  XtCreateApplicationShell - create an additional top-level widget.

Synopsis
  Widget XtCreateApplicationShell(application_name, widget_class, args, num_args)
	 String application_name; /*unused*/
	 WidgetClass widget_class;
	 ArgList args;
	 Cardinal num_args;

Inputs
  application_name
	    This argument is unused.

  widget_class
	    Specifies the widget class for the shell widget to be created.

  args	    Specifies an argument list to override any other resource specifications.

  num_args  Specifies the number of elements in args.

Returns
  A newly created shell widget of class widget_class.

Availability
  Superseded by XtAppCreateShell().

Description
  XtCreateApplicationShell() creates and returns a shell widget of class widget_class.	The created widget has no parent-it is at the root of
  a widget tree and at the top of the resource name hierarchy.

  XtCreateApplicationShell() creates the widget by calling XtAppCreateShell() passing a NULL application_name, the application_class that was
  passed to XtInitialize(), the display that was opened by XtInitialize() and the widget_class, args, and num_args arguments.

Usage
  XtCreateApplicationShell() has been superseded by XtAppCreateShell(), which is substantially more flexible.  You can continue to use XtCre-
  ateApplicationShell() only if you initialize your application with XtInitialize().  We recommend that you use XtAppInitialize(),  XtAppCre-
  ateShell(), and the other XtApp*() application context specific functions.

  See XtAppCreateShell() for more information.

See Also
  XtAppCreateShell(1).

Xt - Initialization													XtCreateApplicationShell()

XtAppCreateShell(3Xt)													     XtAppCreateShell(3Xt)

NAME

       XtAppCreateShell, XtVaAppCreateShell - create top-level widget instance

SYNOPSIS

       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

       Specifies  the name of the application instance.  Specifies the class name of this application.	Specifies the widget class that the appli-
       cation top-level widget should be.  Specifies the display from which to get the resources.  Specifies the argument list from which  to  get
       the  resources.	 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.  XtAppCre-
       ateShell 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

															     XtAppCreateShell(3Xt)