NAME
TopLevelShell widget class − additional top-level shells for an application.
SYNOPSIS
Public Headers:<X11/StringDefs.h>
<X11/Shell.h>
Private Header:<X11/ShellP.h>
Class Name:TopLevelShell
Class Hierarchy:Core → Composite → Shell → WmShell → VendorShell → TopLevelShell
Class Pointer:topLevelShellWidgetClass
Instantiation:widget = XtCreatePopupShell(name,
topLevelShellWidgetClass, ...)
Functions/Macros:XtIsTopLevelShell()
DESCRIPTION
The TopLevelShell widget class is a subclass of VendorShell that is used for additional shells in applications having more than one top-level window (one of which serves as the root of a widget instance tree).
NEW RESOURCES
TopLevelShell defines the following resources:
| Name | Class | Type | Default | Access |
| XtNiconic | XtCIconic | Boolean | False | CSG |
| XtNiconName | XtCIconName | String | NULL | CSG |
| XtNiconNameEncoding | XtCIconNameEncoding | Atom | XA_STRING | CSG |
XtNiconic
If True, the widget is realized as an icon, regardless of the value of the XtNinitialState resource. When the value of this resource is set for a running application, the TopLevelShell will iconify or de-iconify the window appropriately, following the conventions defined by the Inter-Client Communications Conventions Manual. When TopLevelShell de-iconifies a window, it calls XtPopup with the grab_kind argument set to XtGrabNone.
XtNiconName
The icon name for the application. Stored in the WM_ICON_NAME property of the shell’s window. Most window managers will interpret this property and display the name.
XtNiconNameEncoding
The property type of the encoding of the XtNiconName resource. Stored in the WM_ICON_NAME property of the shell’s window.
INHERITED RESOURCES
TopLevelShell inherits the following resources. The resources are listed alphabetically, along with the superclass that defines them.
| Resource | Inherited From | Resource | Inherited From |
| XtNaccelerators | Core | XtNmaxHeight | WMShell |
| XtNallowShellResize | Shell | XtNmaxWidth | WMShell |
| XtNancestorSensitive | Core | XtNminAspectX | WMShell |
| XtNbackground | Core | XtNminAspectY | WMShell |
| XtNbackgroundPixmap | Core | XtNminHeight | WMShell |
| XtNbaseHeight | WMShell | XtNminWidth | WMShell |
| XtNbaseWidth | WMShell | XtNmwmDecorations | VendorShell |
| XtNborderColor | Core | XtNmwmFunctions | VendorShell |
| XtNborderPixmap | Core | XtNmwmInputMode | VendorShell |
| XtNborderWidth | Core | XtNmwmMenu | VendorShell |
| XtNchildren | Composite | XtNnumChildren | Composite |
| XtNcolormap | Core | XtNoverrideRedirect | Shell |
| XtNcreatePopupChild- | Shell | XtNpopdownCallback | Shell |
| Proc | |||
| XtNdefaultFontList | VendorShell | XtNpopupCallback | Shell |
| XtNdeleteResponse | VendorShell | XtNsaveUnder | Shell |
| XtNdepth | Core | XtNscreen | Core |
| XtNdestroyCallback | Core | XtNsensitive | Core |
| XtNgeometry | Shell | XtNshellUnitType | VendorShell |
| XtNheight | Core | XtNtitle | WMShell |
| XtNheightInc | WMShell | XtNtitleEncoding | WMShell |
| XtNiconMask | WMShell | XtNtransient | WMShell |
| XtNiconPixmap | WMShell | XtNtranslations | Core |
| XtNiconWindow | WMShell | XtNuseAsyncGeometry | VendorShell |
| XtNiconX | WMShell | XtNvisual | Shell |
| XtNiconY | WMShell | XtNwaitForWm | WMShell |
| XtNinitialResources- | Core | XtNwidth | Core |
| Persistent | |||
| XtNinitialState | WMShell | XtNwidthInc | WMShell |
| XtNinput | WMShell | XtNwindowGroup | WMShell |
| XtNinsertPosition | Composite | XtNwinGravity | WMShell |
| XtNkeyboardFocusPolicy | VendorShell | XtNwmTimeout | WMShell |
| XtNmappedWhenManaged | Core | XtNx | Core |
| XtNmaxAspectX | WMShell | XtNy | Core |
| XtNmaxAspectY | WMShell | ||
CLASS STRUCTURE
The TopLevelShell class structure contains only an extension field: typedef struct { XtPointer extension; /∗ pointer to extension record ∗/ } TopLevelShellClassPart;
typedef struct _TopLevelShellClassRec { CoreClassPart core_class; CompositeClassPart composite_class; ShellClassPart shell_class; WMShellClassPart wm_shell_class; VendorShellClassPart vendor_shell_class; TopLevelShellClassPart top_level_shell_class; } TopLevelShellClassRec; There is no extension defined for TopLevelShell, and the extension field should be NULL.
INSTANCE STRUCTURE
The TopLevelShell instance structure contains at least the following fields (which need not be in this order): typedef struct { String icon_name; Boolean iconic; Atom icon_name_encoding; } TopLevelShellPart;
typedef struct { CorePart core; CompositePart composite; ShellPart shell; WMShellPart wm; VendorShellPart vendor; TopLevelShellPart topLevel; } TopLevelShellRec, ∗TopLevelShellWidget;
SEE ALSO
ShellUNIX SYSTEM V/68 and V/88 Release 4, WMShellUNIX SYSTEM V/68 and V/88 Release 4.