TOPLEVELSHELL(3)

💖 TopLevelShell — the TopLevelShell widget class 💖

so this is a library call from the X/Motif girlies, and bestie, it's literally the blueprint for every normal top-level window you're ever gonna pop open. Let's get into it 🫶

---

✨ NAME ✨

TopLevelShell — the TopLevelShell widget class 👑

---

✨ SYNOPSIS ✨

#include <Xm/Xm.h>
#include <X11/Shell.h>

---

✨ DESCRIPTION ✨

Okay so TopLevelShell is the widget you reach for when you need normal top-level windows — like, any extra top-level widgets your app needs beyond the main one. It's giving "yes I'm a whole window, and I'm thriving" 🌈

🦋 Classes 🦋

TopLevelShell inherits all its behavior and resources from Core, Composite, Shell, WMShell, and VendorShell. Family tree ate, no cap 💅

• The class pointer is topLevelShellWidgetClass.
• The class name is TopLevelShell.

---

🌸 New Resources 🌸

So here's the thing — these are the widget resources the programmer uses to specify data. You can also set the resource values for the inherited classes to set attributes for this widget, iconic behavior fr fr.

To reference a resource by name or by class in a .Xdefaults file, remove the XmN or XmC prefix and use the remaining letters. To specify one of the defined values for a resource in a .Xdefaults file, remove the Xm prefix and use the remaining letters (either lowercase or uppercase, but include any underscores between words).

The codes in the access column tell you what you can do with each resource:

• C — can be set at creation time
• S — can be set by using XtSetValues
• G — can be retrieved by using XtGetValues
• N/A — not applicable

👑 TopLevelShell Resource Set 👑

• XmNiconic — Class: XmCIconic · Type: Boolean · Default: False · Access: CSG
• XmNiconName — Class: XmCIconName · Type: String · Default: NULL · Access: CSG
• XmNiconNameEncoding — Class: XmCIconNameEncoding · Type: Atom · Default: dynamic · Access: CSG

---

🎀 the resource tea, one by one 🎀

• XmNiconic — if this is True when the widget is created, it specifies that the widget should start as an icon when it is realized. A value of False means the widget is not to be realized as an icon. Heads up bestie: this resource will only override the XmNinitialState resource when it's specified in the call that creates the widget. iykyk ✨
• XmNiconName — specifies the short form of the application name that the window manager displays when the application is iconified. When XtGetValues is called on this resource, the returned value is a pointer to the actual resource value and should not be freed — do NOT touch it, hands off 🫶
• XmNiconNameEncoding — specifies a property type that represents the encoding of the XmNiconName string. If a language procedure has been set, the default is None; otherwise, the default is XA_STRING. When the widget is realized, if the value is None, the corresponding name is assumed to be in the current locale. The name is passed to XmbTextListToTextProperty with an encoding style of XStdICCTextStyle. The resulting encoding is STRING if the name is fully convertible to STRING, otherwise COMPOUND_TEXT. And plot twist — the values of the encoding resources are not changed; they remain None. 💀

---

💜 Inherited Resources 💜

TopLevelShell inherits behavior and resources from the following superclasses. For a complete description of each resource, refer to the reference page for that superclass. (yes, go read those too, don't be shy 💖)

---

to be continued… part 2 incoming, don't go anywhere bestie 🦋

✨ VendorShell Resource Set ✨

okay bestie, here's the whole VendorShell resource set — every single one, no skips, no cap. the columns are Name, Class, Type, Default, and Access, and I'm keeping them exactly as they are 💅

• XmNaudibleWarning — Class: XmCAudibleWarning, Type: unsigned char, Default: XmBELL, Access: CSG 🦋
• XmNbuttonFontList — Class: XmCButtonFontList, Type: XmFontList, Default: dynamic, Access: CSG 🎀
• XmNbuttonRenderTable — Class: XmCButtonRenderTable, Type: XmRenderTable, Default: dynamic, Access: CSG ✨
• XmNdefaultFontList — Class: XmCDefaultFontList, Type: XmFontList, Default: dynamic, Access: CG 🌸
• XmNdeleteResponse — Class: XmCDeleteResponse, Type: unsigned char, Default: XmDESTROY, Access: CSG 💖
• XmNinputMethod — Class: XmCInputMethod, Type: String, Default: NULL, Access: CSG 🧚
• XmNinputPolicy — Class: XmCInputPolicy, Type: XmInputPolicy, Default: XmPER_SHELL, Access: CSG 🔥
• XmNkeyboardFocusPolicy — Class: XmCKeyboardFocusPolicy, Type: unsigned char, Default: XmEXPLICIT, Access: CSG 👑
• XmNlabelFontList — Class: XmCLabelFontList, Type: XmFontList, Default: dynamic, Access: CSG 🍓
• XmNlabelRenderTable — Class: XmCLabelRenderTabel, Type: XmRenderTable, Default: dynamic, Access: CSG 🫶
• XmNlayoutDirection — Class: XmCLayoutDirection, Type: XmDirection, Default: XmLEFT_TO_RIGHT, Access: CG 🌈
• XmNmwmDecorations — Class: XmCMwmDecorations, Type: int, Default: -1, Access: CG 💜
• XmNmwmFunctions — Class: XmCMwmFunctions, Type: int, Default: -1, Access: CG ⭐
• XmNmwmInputMode — Class: XmCMwmInputMode, Type: int, Default: -1, Access: CG 💫
• XmNmwmMenu — Class: XmCMwmMenu, Type: String, Default: NULL, Access: CG 🎀
• XmNpreeditType — Class: XmCPreeditType, Type: String, Default: dynamic, Access: CSG 🌸
• XmNshellUnitType — Class: XmCShellUnitType, Type: unsigned char, Default: XmPIXELS, Access: CSG 🦋
• XmNtextFontList — Class: XmCTextFontList, Type: XmFontList, Default: dynamic, Access: CSG 💖
• XmNtextRenderTable — Class: XmCTextRenderTable, Type: XmRenderTable, Default: dynamic, Access: CSG ✨
• XmNunitType — Class: XmCUnitType, Type: unsigned char, Default: XmPIXELS, Access: CSG 🔥
• XmNuseAsyncGeometry — Class: XmCUseAsyncGeometry, Type: Boolean, Default: False, Access: CSG 👑

WMShell Resource Set 💖✨

okay bestie, here's the entire resource lineup for the WMShell class — every name, every class, every type, every default, every access code. nothing skipped, nothing summarised, no cap 🫶 and yes, literally every single one of them is access CSG, so she's serving full create-set-get energy the whole way down 💅

• XmNbaseHeight — class XmCBaseHeight, type int, default XtUnspecifiedShellInt, access CSG — base height, the name really said it all 💖
• XmNbaseWidth — class XmCBaseWidth, type int, default XtUnspecifiedShellInt, access CSG — and her twin sister, base width, matching energy 🌸
• XmNheightInc — class XmCHeightInc, type int, default XtUnspecifiedShellInt, access CSG — height increment, the little steps, obsessed
• XmNiconMask — class XmCIconMask, type Pixmap, default NULL, access CSG — a mask?? a pixmap?? default NULL?? mysterious main character behaviour 🙈
• XmNiconPixmap — class XmCIconPixmap, type Pixmap, default NULL, access CSG — the icon pixmap herself, also starting out as NULL 💜
• XmNiconWindow — class XmCIconWindow, type Window, default NULL, access CSG — icon window, NULL default, living her unset era ✨
• XmNiconX — class XmCIconX, type int, default XtUnspecifiedShellInt, access CSG — icon x, lowkey iconic 🎀
• XmNiconY — class XmCIconY, type int, default XtUnspecifiedShellInt, access CSG — icon y, and together they're the coordinate duo fr fr
• XmNinitialState — class XmCInitialState, type int, default NormalState, access CSG — starts out NormalState, which is so real of her 😌
• XmNinput — class XmCInput, type Boolean, default True, access CSG — True by default, she came ready to receive input bestie 💅
• XmNmaxAspectX — class XmCMaxAspectX, type int, default XtUnspecifiedShellInt, access CSG — max aspect x, part one of the aspect girlies
• XmNmaxAspectY — class XmCMaxAspectY, type int, default XtUnspecifiedShellInt, access CSG — max aspect y, part two 🦋
• XmNmaxHeight — class XmCMaxHeight, type int, default XtUnspecifiedShellInt, access CSG — max height, she's got limits (literally)
• XmNmaxWidth — class XmCMaxWidth, type int, default XtUnspecifiedShellInt, access CSG — max width, same vibe, different axis ✨
• XmNminAspectX — class XmCMinAspectX, type int, default XtUnspecifiedShellInt, access CSG — min aspect x, the floor of the aspect situation
• XmNminAspectY — class XmCMinAspectY, type int, default XtUnspecifiedShellInt, access CSG — min aspect y, keeping it symmetrical 🌈
• XmNminHeight — class XmCMinHeight, type int, default XtUnspecifiedShellInt, access CSG — min height, the smallest she's willing to go
• XmNminWidth — class XmCMinWidth, type int, default XtUnspecifiedShellInt, access CSG — min width, and that's the whole min/max arc complete 💖
• XmNtitle — class XmCTitle, type String, default dynamic, access CSG — title, and her default is literally dynamic, she keeps it moving 😭
• XmNtitleEncoding — class XmCTitleEncoding, type Atom, default dynamic, access CSG — title encoding, an Atom, also dynamic, the encoding girlies ate
• XmNtransient — class XmCTransient, type Boolean, default False, access CSG — False by default, she's not transient unless you say so 💅
• XmNwaitForWm — class XmCWaitForWm, type Boolean, default True, access CSG — waits for the window manager, True default, patient queen 👑
• XmNwidthInc — class XmCWidthInc, type int, default XtUnspecifiedShellInt, access CSG — width increment, the horizontal sibling of XmNheightInc 🎀
• XmNwindowGroup — class XmCWindowGroup, type Window, default dynamic, access CSG — window group, dynamic default, she rolls with her people 🫶
• XmNwinGravity — class XmCWinGravity, type int, default dynamic, access CSG — win gravity, dynamic, she's got her own pull fr fr ✨
• XmNwmTimeout — class XmCWmTimeout, type int, default 5000 ms, access CSG — wm timeout, 5000 ms, that's the clock bestie ⏳🔥

and yeah — every single row up there is CSG on access, no exceptions, no cap 💖

🌸 Shell Resource Set 🌸

okay bestie, here's the whole resource glow-up for the Shell widget class. every single one, no skips, no crumbs 💅

• XmNallowShellResize — Class: XmCAllowShellResize, Type: Boolean, Default: False, Access: CG
• XmNcreatePopupChildProc — Class: XmCCreatePopupChildProc, Type: XtCreatePopupChildProc, Default: NULL, Access: CSG
• XmNgeometry — Class: XmCGeometry, Type: String, Default: NULL, Access: CSG
• XmNoverrideRedirect — Class: XmCOverrideRedirect, Type: Boolean, Default: False, Access: CSG
• XmNpopdownCallback — Class: XmCCallback, Type: XtCallbackList, Default: NULL, Access: C
• XmNpopupCallback — Class: XmCCallback, Type: XtCallbackList, Default: NULL, Access: C
• XmNsaveUnder — Class: XmCSaveUnder, Type: Boolean, Default: False, Access: CSG
• XmNvisual — Class: XmCVisual, Type: Visual *, Default: CopyFromParent, Access: CSG

ngl, that little Access column is doing so much work for us — C means you can set it at creation, G means you can get it, and S means you can set it later with XtSetValues. iykyk ✨

---

🦋 Composite Resource Set 🦋

and these? these are the ones the Composite class is bringing to the function, periodt. inheriting from Shell, but with its own whole vibe 🎀

• XmNchildren — Class: XmCReadOnly, Type: WidgetList, Default: NULL, Access: G
• XmNinsertPosition — Class: XmCInsertPosition, Type: XtOrderProc, Default: NULL, Access: CSG
• XmNnumChildren — Class: XmCReadOnly, Type: Cardinal, Default: 0, Access: G

not XmNchildren and XmNnumChildren both being read-only... the way they just sit there being a whole list and a whole count and you can't even touch them 😭 it's giving "look but don't touch" fr fr

---

✨ Core Resource Set ✨

okay bestie, here's the whole roster, every single one of them, no skips 💅

• XmNaccelerators — class XmCAccelerators, type XtAccelerators, default dynamic, access CSG.
• XmNancestorSensitive — class XmCSensitive, type Boolean, default dynamic, access G.
• XmNbackground — class XmCBackground, type Pixel, default dynamic, access CSG.
• XmNbackgroundPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG.
• XmNborderColor — class XmCBorderColor, type Pixel, default XtDefaultForeground, access CSG.
• XmNborderPixmap — class XmCPixmap, type Pixmap, default XmUNSPECIFIED_PIXMAP, access CSG.
• XmNborderWidth — class XmCBorderWidth, type Dimension, default 0, access CSG.
• XmNcolormap — class XmCColormap, type Colormap, default dynamic, access CG.
• XmNdepth — class XmCDepth, type int, default dynamic, access CG.
• XmNdestroyCallback — class XmCCallback, type XtCallbackList, default NULL, access C.
• XmNheight — class XmCHeight, type Dimension, default dynamic, access CSG.
• XmNinitialResourcesPersistent — class XmCInitialResourcesPersistent, type Boolean, default True, access C.
• XmNmappedWhenManaged — class XmCMappedWhenManaged, type Boolean, default True, access CSG.
• XmNscreen — class XmCScreen, type Screen *, default dynamic, access CG.
• XmNsensitive — class XmCSensitive, type Boolean, default True, access CSG.
• XmNtranslations — class XmCTranslations, type XtTranslations, default dynamic, access CSG.
• XmNwidth — class XmCWidth, type Dimension, default dynamic, access CSG.
• XmNx — class XmCPosition, type Position, default 0, access CSG.
• XmNy — class XmCPosition, type Position, default 0, access CSG.

---

Translations 🦋

There are no translations for TopLevelShell. literally none. the void. empty. not a single one, and that's just how it is 💀

---

RELATED 🔥

go read these next, bestie, they're the whole friend group:

• Composite(3)
• Core(3)
• Shell(3)
• WMShell(3)
• VendorShell(3)

---

and that's the whole page, we did it 🎀 this was TopLevelShell, straight out of the library call manual, and yes the date/version lives down in the footer like always — consider yourself thoroughly read to filth and fully caught up. slay, go build something iconic with it 👑✨💖