TransientShell(Xm)
TransientShell --
the TransientShell widget class
Syntax
#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
[If this table is unreadable, a preformatted table follows]
Name
Class
Type
Default
Access
XmNtransientFor
XmCTransientFor
Widget
NULL
CSG
+----------------+-----------------+--------+---------+--------+
|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
[If this table is unreadable, a preformatted table follows]
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
+-----------------------+------------------------+---------------+-----------+------------+
|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 |
+-----------------------+------------------------+---------------+-----------+------------+
|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
[If this table is unreadable, a preformatted table follows]
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
+-----------------+------------------+---------+-----------------------+--------+
|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
[If this table is unreadable, a preformatted table follows]
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
+------------------------+-------------------------+------------------------+----------------+--------+
|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
[If this table is unreadable, a preformatted table follows]
Name
Class
Type
Default
Access
XmNchildren
XmCReadOnly
WidgetList
NULL
G
XmNinsertPosition
XmCInsertPosition
XtOrderProc
NULL
CSG
XmNnumChildren
XmCReadOnly
Cardinal
0
G
+------------------+-------------------+-------------+---------+--------+
|Name | Class | Type | Default | Access |
+------------------+-------------------+-------------+---------+--------+
|XmNchildren | XmCReadOnly | WidgetList | NULL | G |
+------------------+-------------------+-------------+---------+--------+
|XmNinsertPosition | XmCInsertPosition | XtOrderProc | NULL | CSG |
+------------------+-------------------+-------------+---------+--------+
|XmNnumChildren | XmCReadOnly | Cardinal | 0 | G |
+------------------+-------------------+-------------+---------+--------+
Core resource set
[If this table is unreadable, a preformatted table follows]
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
+------------------------------+-------------------------------+----------------+----------------------+--------+
|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.
See also
Composite (Xm) ,
Core (Xm) ,
Shell (Xm) ,
VendorShell (Xm)
and
WMShell (Xm) .
© 2003 Caldera International, Inc. All rights reserved.
SCO OpenServer Release 5.0.7 -- 11 February 2003