APPLICATIONSHELL(3)

💖 ApplicationShell — the ApplicationShell widget class 💖

okay so bestie, you found it: ApplicationShell(library call) — this is the manual page for the ApplicationShell widget class, and we're gonna go through it together, no stress, no cap. ✨

---

🌸 SYNOPSIS 🌸

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

---

🦋 DESCRIPTION 🦋

So, ApplicationShell is literally the main top-level window for an application. That's its whole thing, that's its job, and it eats every single time. 👑

Quick vibe check though: an application should have more than one ApplicationShell only if it implements multiple logical applications. Like, don't just spawn extras for funsies. One app, one shell, periodt. 💅

---

✨ Classes ✨

ApplicationShell inherits all its behavior and resources from these iconic ancestors, in order:

• Core
• Composite
• Shell
• WMShell
• VendorShell
• TopLevelShell

The class pointer is applicationShellWidgetClass.

The class name is ApplicationShell.

iykyk 🫶

---

🎀 New Resources 🎀

Okay so here's the tea: this table defines the widget resources you (the programmer) get to use to specify data. And here's the best part — you can also set resource values for the inherited classes to set attributes for this widget. So flexible. So generous. We love to see it. 💖

Now, for the .Xdefaults girlies: to reference a resource by name or by class in a .Xdefaults file, you remove the XmN or XmC prefix and just use the remaining letters. And to specify one of the defined values for a resource in a .Xdefaults file, you remove the Xm prefix and use the remaining letters (lowercase OR uppercase, your choice, live your truth — but keep any underscores between words). 🌈

The codes in the access column are the whole personality of this section:

• 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

---

🌟 ApplicationShell Resource Set 🌟

• XmNargc — Class: XmCArgc · Type: int · Default: 0 · Access: CSG
• XmNargv — Class: XmCArgv · Type: String * · Default: NULL · Access: CSG

---

XmNargc — specifies the number of arguments given in the XmNargv resource. The function XtInitialize sets this resource on the shell widget instance it creates by using its parameters as the values. efficient, honestly. ✨

XmNargv — specifies the argument list required by a session manager to restart the application if it is killed. 😭 This list should be updated at appropriate points by the application if a new state has been reached that can be directly restarted. The function XtInitialize sets this resource on the shell widget instance it creates by using its parameters as the values. And listen: 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 free it. Not me warning you twice but also yes I am. 🙈

---

💜 Inherited Resources 💜

ApplicationShell inherits behavior and resources from the following superclasses. For a complete description of each resource, go read the reference page for that superclass — this is a group project and they did their part. 🫶

---

👑 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

🌈 VendorShell Resource Set 🌈

okay bestie, this is the VendorShell Resource Set — the whole entire vibe. columns are Name, Class, Type, Default, and Access. not a single row is getting left behind 💅✨

• 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 💖

🎀 The WMShell Resource Set 🎀

Okay bestie, this is the whole resource table for the WMShell class — every name, every class, every type, every default, every access mode. I'm not skipping one of them, so grab a snack. 🍓

Also, heads up: every single one of these has access CSG — so instead of me saying it 26 times like a broken record, just know it's on all of them, mwah. 💅

• XmNbaseHeight — class XmCBaseHeight, type int, default XtUnspecifiedShellInt. It's giving "I'll tell you later" energy, fr fr.
• XmNbaseWidth — class XmCBaseWidth, type int, default XtUnspecifiedShellInt. Same vibe, but horizontal ✨.
• XmNheightInc — class XmCHeightInc, type int, default XtUnspecifiedShellInt. Height increments, lowkey mysterious until you set it.
• XmNiconMask — class XmCIconMask, type Pixmap, default NULL. No mask unless you hand one over 💀.
• XmNiconPixmap — class XmCIconPixmap, type Pixmap, default NULL. Your icon's glow-up slot, currently empty.
• XmNiconWindow — class XmCIconWindow, type Window, default NULL. Another NULL default, another blank canvas 🦋.
• XmNiconX — class XmCIconX, type int, default XtUnspecifiedShellInt. Icon x-position, unspecified for now.
• XmNiconY — class XmCIconY, type int, default XtUnspecifiedShellInt. Icon y-position, also playing hard to get.
• XmNinitialState — class XmCInitialState, type int, default NormalState. She starts normal, periodt 👑.
• XmNinput — class XmCInput, type Boolean, default True. Input is on by default, as she should be.
• XmNmaxAspectX — class XmCMaxAspectX, type int, default XtUnspecifiedShellInt. Aspect ratio ceiling, x side.
• XmNmaxAspectY — class XmCMaxAspectY, type int, default XtUnspecifiedShellInt. Aspect ratio ceiling, y side.
• XmNmaxHeight — class XmCMaxHeight, type int, default XtUnspecifiedShellInt. How tall is too tall? Unspecified, bestie.
• XmNmaxWidth — class XmCMaxWidth, type int, default XtUnspecifiedShellInt. How wide is too wide? Also unspecified.
• XmNminAspectX — class XmCMinAspectX, type int, default XtUnspecifiedShellInt. Aspect ratio floor, x side.
• XmNminAspectY — class XmCMinAspectY, type int, default XtUnspecifiedShellInt. Aspect ratio floor, y side.
• XmNminHeight — class XmCMinHeight, type int, default XtUnspecifiedShellInt. Minimum height, currently vibing as unspecified.
• XmNminWidth — class XmCMinWidth, type int, default XtUnspecifiedShellInt. Minimum width, same deal 💜.
• XmNtitle — class XmCTitle, type String, default dynamic. The main character's name tag ✨.
• XmNtitleEncoding — class XmCTitleEncoding, type Atom, default dynamic. How that name tag gets encoded.
• XmNtransient — class XmCTransient, type Boolean, default False. Not transient by default, she's here to stay 🫶.
• XmNwaitForWm — class XmCWaitForWm, type Boolean, default True. Yes, we are waiting on the window manager, babe.
• XmNwidthInc — class XmCWidthInc, type int, default XtUnspecifiedShellInt. Width increments, unspecified until you say otherwise.
• XmNwindowGroup — class XmCWindowGroup, type Window, default dynamic. Your little window friend group 🧚.
• XmNwinGravity — class XmCWinGravity, type int, default dynamic. Gravity: dynamic, so she moves how she moves.
• XmNwmTimeout — class XmCWmTimeout, type int, default 5000 ms. Five whole seconds of patience for the WM, iconic ⭐.

---

That's the full set — 26 resources, zero skips, zero edits to the names, classes, types, defaults or access modes. No cap. 💖

🎀 Shell Resource Set 🎀

bestie, the columns are Name, Class, Type, Default, Access — and every single row is right here, no cap 💅

• 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 👑

---

🦋 Composite Resource Set 🦋

and the Composite Resource Set is also serving, columns are Name, Class, Type, Default, Access — here we go 🫶

• 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 🌸

💖 Core Resource Set 💖

okay bestie, here's the whole squad of resources this widget ships with — every name, class, type, default and access level, nothing skipped, nothing hidden, we're giving thorough 💅

• 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 ApplicationShell. That's it. That's the whole section. Empty. Void. Not a single one. 🙈

---

🫶 RELATED 🫶

the extended fam, the mutuals, the group chat that actually shows up:

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

---

and that's a wrap on the whole page, bestie 🎀 this one's ApplicationShell(library call) — the library call section of the manual, in case you were wondering where to look it up, iykyk 💜 go forth and shell responsibly, ily, bye ✨🦋