---
name: "TransientShell"
section: "3"
platform: "linux"
package: "openmotif"
version: "2.3.8-4"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/TransientShell"
---

# TransientShell(3)

The TransientShell widget class

## NAME

**TransientShell** — The TransientShell widget class

## SYNOPSIS

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

## DESCRIPTION

TransientShell is used for shell windows that can be manipulated by the window manager, but are not allowed to be iconified separately. For example, DialogBoxes make no sense without their associated application. They are iconified by the window manager only if the main application shell is iconified.

### Classes

TransientShell inherits behavior and resources from **Core**, **Composite**, **Shell**, **WMShell**, and **VendorShell**.

The class pointer is **transientShellWidgetClass**.

The class name is **TransientShell**.

### New Resources

The following table defines a set of widget resources used by the programmer to specify data. The programmer can also set the resource values for the inherited classes to set attributes for this widget. 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 (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using **XtSetValues** (S), retrieved by using **XtGetValues** (G), or is not applicable (N/A).

In addition to these new resources, **TransientShell** overrides the **XmNsaveUnder** resource in **Shell** and the **XmNtransient** resource in **WMShell**.

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **TransientShell Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNtransientFor | XmCTransientFor | Widget | NULL | CSG |
|  |  |  |  |  |  |

- **XmNtransientFor**

  Specifies a widget that the shell acts as a pop-up for. If this resource is NULL or is a widget that has not been realized, the **XmNwindowGroup** is used instead.

### Inherited Resources

TransientShell inherits behavior and resources from the superclasses described in the following tables, which define sets of widget resources used by the programmer to specify data. For a complete description of each resource, refer to the reference page for that superclass.

The programmer can also set the resource values for the inherited classes to set attributes for this widget. 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 (in either lowercase or uppercase, but include any underscores between words). The codes in the access column indicate if the given resource can be set at creation time (C), set by using **XtSetValues** (S), retrieved by using **XtGetValues** (G), or is not applicable (N/A).

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **VendorShell Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNaudibleWarning | XmCAudibleWarning | unsigned char | XmBELL | CSG |
|  |  |  |  |  |  |
| XmNbuttonFontList | XmCButtonFontList | XmFontList | dynamic | CSG |
|  |  |  |  |  |  |
| XmNbuttonRenderTable | XmCButtonRenderTable | XmRenderTable | dynamic | CSG |
|  |  |  |  |  |  |
| XmNdefaultFontList | XmCDefaultFontList | XmFontList | dynamic | CG |
|  |  |  |  |  |  |
| XmNdeleteResponse | XmCDeleteResponse | unsigned char | XmDESTROY | CSG |
|  |  |  |  |  |  |
| XmNinputMethod | XmCInputMethod | String | NULL | CSG |
|  |  |  |  |  |  |
| XmNinputPolicy | XmCInputPolicy | XmInputPolicy | XmPER\_SHELL | CSG |
|  |  |  |  |  |  |
| XmNkeyboardFocusPolicy | XmCKeyboardFocusPolicy | unsigned char | XmEXPLICIT | CSG |
|  |  |  |  |  |  |
| XmNlabelFontList | XmCLabelFontList | XmFontList | dynamic | CSG |
|  |  |  |  |  |  |
| XmNlabelRenderTable | XmCLabelRenderTabel | XmRenderTable | dynamic | CSG |
|  |  |  |  |  |  |
| XmNlayoutDirection | XmCLayoutDirection | XmDirection | XmLEFT\_TO\_RIGHT | CG |
|  |  |  |  |  |  |
| XmNmwmDecorations | XmCMwmDecorations | int | -1 | CG |
|  |  |  |  |  |  |
| XmNmwmFunctions | XmCMwmFunctions | int | -1 | CG |
|  |  |  |  |  |  |
| XmNmwmInputMode | XmCMwmInputMode | int | -1 | CG |
|  |  |  |  |  |  |
| XmNmwmMenu | XmCMwmMenu | String | NULL | CG |
|  |  |  |  |  |  |
| XmNpreeditType | XmCPreeditType | String | dynamic | CSG |
|  |  |  |  |  |  |
| XmNshellUnitType | XmCShellUnitType | unsigned char | XmPIXELS | CSG |
|  |  |  |  |  |  |
| XmNtextFontList | XmCTextFontList | XmFontList | dynamic | CSG |
|  |  |  |  |  |  |
| XmNtextRenderTable | XmCTextRenderTable | XmRenderTable | dynamic | CSG |
|  |  |  |  |  |  |
| XmNunitType | XmCUnitType | unsigned char | XmPIXELS | CSG |
|  |  |  |  |  |  |
| XmNuseAsyncGeometry | XmCUseAsyncGeometry | Boolean | False | CSG |
|  |  |  |  |  |  |

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **WMShell Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNbaseHeight | XmCBaseHeight | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNbaseWidth | XmCBaseWidth | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNheightInc | XmCHeightInc | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNiconMask | XmCIconMask | Pixmap | NULL | CSG |
|  |  |  |  |  |  |
| XmNiconPixmap | XmCIconPixmap | Pixmap | NULL | CSG |
|  |  |  |  |  |  |
| XmNiconWindow | XmCIconWindow | Window | NULL | CSG |
|  |  |  |  |  |  |
| XmNiconX | XmCIconX | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNiconY | XmCIconY | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNinitialState | XmCInitialState | int | NormalState | CSG |
|  |  |  |  |  |  |
| XmNinput | XmCInput | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNmaxAspectX | XmCMaxAspectX | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNmaxAspectY | XmCMaxAspectY | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNmaxHeight | XmCMaxHeight | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNmaxWidth | XmCMaxWidth | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNminAspectX | XmCMinAspectX | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNminAspectY | XmCMinAspectY | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNminHeight | XmCMinHeight | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNminWidth | XmCMinWidth | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNtitle | XmCTitle | String | dynamic | CSG |
|  |  |  |  |  |  |
| XmNtitleEncoding | XmCTitleEncoding | Atom | dynamic | CSG |
|  |  |  |  |  |  |
| XmNtransient | XmCTransient | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNwaitForWm | XmCWaitForWm | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNwidthInc | XmCWidthInc | int | XtUnspecifiedShellInt | CSG |
|  |  |  |  |  |  |
| XmNwindowGroup | XmCWindowGroup | Window | dynamic | CSG |
|  |  |  |  |  |  |
| XmNwinGravity | XmCWinGravity | int | dynamic | CSG |
|  |  |  |  |  |  |
| XmNwmTimeout | XmCWmTimeout | int | 5000 ms | CSG |
|  |  |  |  |  |  |

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **Shell Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNallowShellResize | XmCAllowShellResize | Boolean | False | CG |
|  |  |  |  |  |  |
| XmNcreatePopupChildProc | XmCCreatePopupChildProc | XtCreatePopupChildProc | NULL | CSG |
|  |  |  |  |  |  |
| XmNgeometry | XmCGeometry | String | NULL | CSG |
|  |  |  |  |  |  |
| XmNoverrideRedirect | XmCOverrideRedirect | Boolean | False | CSG |
|  |  |  |  |  |  |
| XmNpopdownCallback | XmCCallback | XtCallbackList | NULL | C |
|  |  |  |  |  |  |
| XmNpopupCallback | XmCCallback | XtCallbackList | NULL | C |
|  |  |  |  |  |  |
| XmNsaveUnder | XmCSaveUnder | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNvisual | XmCVisual | Visual \* | CopyFromParent | CSG |
|  |  |  |  |  |  |

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **Composite Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNchildren | XmCReadOnly | WidgetList | NULL | G |
|  |  |  |  |  |  |
| XmNinsertPosition | XmCInsertPosition | XtOrderProc | NULL | CSG |
|  |  |  |  |  |  |
| XmNnumChildren | XmCReadOnly | Cardinal | 0 | G |
|  |  |  |  |  |  |

| | | | | | |
| --- | --- | --- | --- | --- | --- |
| **Core Resource Set** |
| **Name** | **Class** | **Type** | **Default** | **Access** |
|  |  |  |  |  |  |
| XmNaccelerators | XmCAccelerators | XtAccelerators | dynamic | CSG |
|  |  |  |  |  |  |
| XmNancestorSensitive | XmCSensitive | Boolean | dynamic | G |
|  |  |  |  |  |  |
| XmNbackground | XmCBackground | Pixel | dynamic | CSG |
|  |  |  |  |  |  |
| XmNbackgroundPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED\_PIXMAP | CSG |
|  |  |  |  |  |  |
| XmNborderColor | XmCBorderColor | Pixel | XtDefaultForeground | CSG |
|  |  |  |  |  |  |
| XmNborderPixmap | XmCPixmap | Pixmap | XmUNSPECIFIED\_PIXMAP | CSG |
|  |  |  |  |  |  |
| XmNborderWidth | XmCBorderWidth | Dimension | 0 | CSG |
|  |  |  |  |  |  |
| XmNcolormap | XmCColormap | Colormap | dynamic | CG |
|  |  |  |  |  |  |
| XmNdepth | XmCDepth | int | dynamic | CG |
|  |  |  |  |  |  |
| XmNdestroyCallback | XmCCallback | XtCallbackList | NULL | C |
|  |  |  |  |  |  |
| XmNheight | XmCHeight | Dimension | dynamic | CSG |
|  |  |  |  |  |  |
| XmNinitialResourcesPersistent | XmCInitialResourcesPersistent | Boolean | True | C |
|  |  |  |  |  |  |
| XmNmappedWhenManaged | XmCMappedWhenManaged | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNscreen | XmCScreen | Screen \* | dynamic | CG |
|  |  |  |  |  |  |
| XmNsensitive | XmCSensitive | Boolean | True | CSG |
|  |  |  |  |  |  |
| XmNtranslations | XmCTranslations | XtTranslations | dynamic | CSG |
|  |  |  |  |  |  |
| XmNwidth | XmCWidth | Dimension | dynamic | CSG |
|  |  |  |  |  |  |
| XmNx | XmCPosition | Position | 0 | CSG |
|  |  |  |  |  |  |
| XmNy | XmCPosition | Position | 0 | CSG |
|  |  |  |  |  |  |

### Translations

There are no translations for TransientShell.

## RELATED

[**Composite**(3)](/Composite/3.md), [**Core**(3)](/Core/3.md), [**Shell**(3)](/Shell/3.md), [**VendorShell**(3)](/VendorShell/3.md), and [**WMShell**(3)](/WMShell/3.md).
