TransientShell(3X) SDK X11 R4.11MU05 TransientShell(3X)
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, Dialog boxes 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, 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 for which the shell acts as a pop-up.
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 following
superclasses. For a complete description of each resource, refer to
the man page for that superclass.
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).
+--------------------------------------------------------------------------------------+
| VendorShell Resource Set |
+-----------------------+------------------------+---------------+------------+--------+
|Name | Class | Type | Default | Access |
+-----------------------+------------------------+---------------+------------+--------+
+-----------------------+------------------------+---------------+------------+--------+
|XmNaudibleWarning | XmCAudibleWarning | unsigned char | XmBELL | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNbuttonFontList | XmCButtonFontList | XmFontList | dynamic | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNdefaultFontList | XmCDefaultFontList | XmFontList | dynamic | CG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNdeleteResponse | XmCDeleteResponse | unsigned char | XmDESTROY | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNinputMethod | XmCInputMethod | String | NULL | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNkeyboardFocusPolicy | XmCKeyboardFocusPolicy | unsigned char | XmEXPLICIT | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNlabelFontList | XmCLabelFontList | XmFontList | dynamic | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNmwmDecorations | XmCMwmDecorations | int | -1 | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNmwmFunctions | XmCMwmFunctions | int | -1 | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNmwmInputMode | XmCMwmInputMode | int | -1 | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNmwmMenu | XmCMwmMenu | String | NULL | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNpreeditType | XmCPreeditType | String | dynamic | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNshellUnitType | XmCShellUnitType | unsigned char | XmPIXELS | CSG |
+-----------------------+------------------------+---------------+------------+--------+
|XmNtextFontList | XmCTextFontList | XmFontList | dynamic | 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 | -1 | CSG |
+-----------------+------------------+---------+-----------------------+--------+
|XmNiconY | XmCIconY | int | -1 | 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 | 1 | 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 INFORMATION
Composite(3X), Core(3X), Shell(3X), VendorShell(3X), and WMShell(3X).
Licensed material--property of copyright holder(s)