XmDialogShell(3X) XmDialogShell(3X)
NAME
XmDialogShell - The DialogShell widget class
SYNOPSIS
#include <Xm/DialogS.h>
DESCRIPTION
Modal and modeless dialogs use DialogShell as the Shell parent. DialogShell widgets cannot be iconified. Instead, all secondary
DialogShell widgets associated with an ApplicationShell widget are iconified and de-iconified as a group with the primary widget.
The client indirectly manipulates DialogShell via the convenience interfaces during creation, and it can directly manipulate its Bullet-
inBoard-derived child. Much of the functionality of DialogShell assumes that its child is a BulletinBoard subclass, although it can poten-
tially stand alone.
Setting XmNheight, XmNwidth, or XmNborderWidth for either a DialogShell or its managed child usually sets that resource to the same value
in both the parent and the child. When an off-the-spot input method exists, the height and width of the shell may be greater than those of
the managed child in order to accommodate the input method. In this case setting XmNheight or XmNwidth for the shell does not necessarily
set that resource to the same value in the managed child, and setting XmNheight or XmNwidth for the child does not necessarily set that
resource to the same value in the shell.
For the managed child of a DialogShell, regardless of the value of the shell's XmNallowShellResize, setting XmNx or XmNy sets the corre-
sponding resource of the parent but does not change the child's position relative to the parent. XtGetValues for the child's XmNx or XmNy
yields the value of the corresponding resource in the parent. The x and y coordinates of the child's upper left outside corner relative to
the parent's upper left inside corner are both zero minus the value of XmNborderWidth.
Note that the Inter-Client Communication Conventions Manual allows a window manager to change or control the border width of a reparented
top-level window.
Classes
DialogShell inherits behavior and resources from Core, Composite, Shell, WMShell, VendorShell, and TransientShell classes.
The class pointer is xmDialogShellWidgetClass.
The class name is XmDialogShell.
New Resources
DialogShell defines no new resources but overrides the XmNdeleteResponse resource in the VendorShell class.
Inherited Resources
DialogShell 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).
TransientShell Resource Set
Class: XmCTransientFor Default: NULL Type: Widget Access: CSG
VendorShell Resource Set
Class: XmCAudibleWarning Default: XmBELL Type: unsigned char Access: CSG Class: XmCButtonFontList Default: dynamic Type: XmFontList
Access: CSG Class: XmCDefaultFontList Default: dynamic Type: XmFontList Access: CG Class: XmCDeleteResponse Default: XmUNMAP Type:
unsigned char Access: CSG Class: XmCInputMethod Default: NULL Type: String Access: CSG Class: XmCKeyboardFocusPolicy Default: XmEXPLICIT
Type: unsigned char Access: CSG Class: XmCLabelFontList Default: dynamic Type: XmFontList Access: CSG Class: XmCMwmDecorations Default:
-1 Type: int Access: CSG Class: XmCMwmFunctions Default: -1 Type: int Access: CSG Class: XmCMwmInputMode Default: -1 Type: int Access:
CSG Class: XmCMwmMenu Default: NULL Type: String Access: CSG Class: XmCPreeditType Default: dynamic Type: String Access: CSG Class: XmC-
ShellUnitType Default: XmPIXELS Type: unsigned char Access: CSG Class: XmCTextFontList Default: dynamic Type: XmFontList Access: CSG
Class: XmCUseAsyncGeometry Default: False Type: Boolean Access: CSG
WMShell Resource Set
Class: XmCBaseHeight Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCBaseWidth Default: XtUnspecifiedShellInt Type: int
Access: CSG Class: XmCHeightInc Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCIconMask Default: NULL Type: Pixmap
Access: CSG Class: XmCIconPixmap Default: NULL Type: Pixmap Access: CSG Class: XmCIconWindow Default: NULL Type: Window Access: CSG
Class: XmCIconX Default: -1 Type: int Access: CSG Class: XmCIconY Default: -1 Type: int Access: CSG Class: XmCInitialState Default: Nor-
malState Type: int Access: CSG Class: XmCInput Default: True Type: Boolean Access: CSG Class: XmCMaxAspectX Default: XtUnspecified-
ShellInt Type: int Access: CSG Class: XmCMaxAspectY Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCMaxHeight Default:
XtUnspecifiedShellInt Type: int Access: CSG Class: XmCMaxWidth Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCMinAspectX
Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCMinAspectY Default: XtUnspecifiedShellInt Type: int Access: CSG Class:
XmCMinHeight Default: XtUnspecifiedShellInt Type: int Access: CSG Class: XmCMinWidth Default: XtUnspecifiedShellInt Type: int Access: CSG
Class: XmCTitle Default: dynamic Type: String Access: CSG Class: XmCTitleEncoding Default: dynamic Type: Atom Access: CSG Class: XmCTran-
sient Default: True Type: Boolean Access: CSG Class: XmCWaitForWm Default: True Type: Boolean Access: CSG Class: XmCWidthInc Default:
XtUnspecifiedShellInt Type: int Access: CSG Class: XmCWindowGroup Default: dynamic Type: Window Access: CSG Class: XmCWinGravity Default:
dynamic Type: int Access: CSG Class: XmCWmTimeout Default: 5000 ms Type: int Access: CSG
Shell Resource Set
Class: XmCAllowShellResize Default: False Type: Boolean Access: CG Class: XmCCreatePopupChildProc Default: NULL Type: XtCreatePopupChild-
Proc Access: CSG Class: XmCGeometry Default: NULL Type: String Access: CSG Class: XmCOverrideRedirect Default: False Type: Boolean
Access: CSG Class: XmCCallback Default: NULL Type: XtCallbackList Access: C Class: XmCCallback Default: NULL Type: XtCallbackList Access:
C Class: XmCSaveUnder Default: True Type: Boolean Access: CSG Class: XmCVisual Default: CopyFromParent Type: Visual * Access: CSG
Composite Resource Set
Class: XmCReadOnly Default: NULL Type: WidgetList Access: G Class: XmCInsertPosition Default: NULL Type: XtOrderProc Access: CSG Class:
XmCReadOnly Default: 0 Type: Cardinal Access: G
Core Resource Set
Class: XmCAccelerators Default: dynamic Type: XtAccelerators Access: CSG Class: XmCSensitive Default: dynamic Type: Boolean Access: G
Class: XmCBackground Default: dynamic Type: Pixel Access: CSG Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap Access: CSG
Class: XmCBorderColor Default: XtDefaultForeground Type: Pixel Access: CSG Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap
Access: CSG Class: XmCBorderWidth Default: 1 Type: Dimension Access: CSG Class: XmCColormap Default: dynamic Type: Colormap Access: CG
Class: XmCDepth Default: dynamic Type: int Access: CG Class: XmCCallback Default: NULL Type: XtCallbackList Access: C Class: XmCHeight
Default: dynamic Type: Dimension Access: CSG Class: XmCInitialResourcesPersistent Default: True Type: Boolean Access: C Class: XmCMapped-
WhenManaged Default: True Type: Boolean Access: CSG Class: XmCScreen Default: dynamic Type: Screen * Access: CG Class: XmCSensitive
Default: True Type: Boolean Access: CSG Class: XmCTranslations Default: dynamic Type: XtTranslations Access: CSG Class: XmCWidth Default:
dynamic Type: Dimension Access: CSG Class: XmCPosition Default: 0 Type: Position Access: CSG Class: XmCPosition Default: 0 Type: Posi-
tion Access: CSG
Translations
There are no translations for XmDialogShell.
SEE ALSO
Composite(3X), Core(3X), Shell(3X), TransientShell(3X), WMShell(3X), VendorShell(3X), XmCreateDialogShell(3X)
XmDialogShell(3X)