TopLevelShell()TopLevelShell()NameTopLevelShell widget class - additional top-level shells for an appli‐
cation.
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 ResourcesTopLevelShell 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 ResourcesTopLevelShell 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
ProcXtNdefaultFontList 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
PersistentXtNinitialState 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 AlsoShell(3), WMShell(3).
Intrinsics ClassesTopLevelShell()