XtAppCreateShell(3) XT FUNCTIONS XtAppCreateShell(3)

# [NAME](#NAME)

XtAppCreateShell, XtVaAppCreateShell - create top-level widget instance

# [SYNTAX](#SYNTAX)

#include <X11/Intrinsic.h>

Widget XtAppCreateShell(const char \**application\_name*, const char \**application\_class*, WidgetClass *widget\_class*, Display \**display*, ArgList *args*, Cardinal *num\_args*);

Widget XtVaAppCreateShell(const char * *application\_name*, const char * *application\_class*, WidgetClass *widget\_class*, Display \**display*, ...);

# [ARGUMENTS](#ARGUMENTS)

[*application\_name*](#application_name)

Specifies the name of the application instance.

[*application\_class*](#application_class)

Specifies the class name of this application, which usually is the generic name for all instances of this application.

[*widget\_class*](#widget_class)

Specifies the widget class that the application top-level widget should be.

[*display*](#display)

Specifies the display from which to get the resources.

[*args*](#args)

Specifies the argument list from which to get the resources.

[*num\_args*](#num_args)

Specifies the number of arguments in the argument list.

*...*

Specifies the variable argument list from which to get the resources.

# [DESCRIPTION](#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 property set for session managers (see Chapter 4).

# [SEE ALSO](#SEE_ALSO)

[XtCreateWidget(3)](/man/os/libxt/XtCreateWidget.3)  
*X Toolkit Intrinsics - C Language Interface*  
*Xlib - C Language X Interface*

libXt 1.3.1 X Version 11

---

Document: XtVaAppCreateShell(3) from libxt 1.3.1-r8 (Chainguard OS)
Source: https://gitlab.freedesktop.org/xorg/lib/libxt.git