XmDialogShell(3X) OSF/Motif XmDialogShell(3X)NAMEXmDialogShell - 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
potentially 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 correspond‐
ing 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 XmNdeleteRe‐
sponse resource in the VendorShell class.
Inherited Resources
DialogShell inherits behavior and resources from the following super‐
classes. 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 pro‐
grammer to specify data. The programmer can also set the resource val‐
ues 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
───────────────────────────────────────────────
Name Default Access
Class Type
───────────────────────────────────────────────
───────────────────────────────────────────────
XmNtransientFor NULL CSG
XmCTransientFor Widget
───────────────────────────────────────────────
VendorShell Resource Set
─────────────────────────────────────────────────────────────
Name Default Access
Class Type
─────────────────────────────────────────────────────────────
─────────────────────────────────────────────────────────────
XmNaudibleWarning XmBELL CSG
XmCAudibleWarning unsigned char
─────────────────────────────────────────────────────────────
XmNbuttonFontList dynamic CSG
XmCButtonFontList XmFontList
─────────────────────────────────────────────────────────────
XmNdefaultFontList dynamic CG
XmCDefaultFontList XmFontList
─────────────────────────────────────────────────────────────
XmNdeleteResponse XmUNMAP CSG
XmCDeleteResponse unsigned char
─────────────────────────────────────────────────────────────
XmNinputMethod NULL CSG
XmCInputMethod String
─────────────────────────────────────────────────────────────
XmNkeyboardFocusPolicy XmEXPLICIT CSG
XmCKeyboardFocusPolicy unsigned char
─────────────────────────────────────────────────────────────
XmNlabelFontList dynamic CSG
XmCLabelFontList XmFontList
─────────────────────────────────────────────────────────────
XmNmwmDecorations -1 CSG
XmCMwmDecorations int
─────────────────────────────────────────────────────────────
XmNmwmFunctions -1 CSG
XmCMwmFunctions int
─────────────────────────────────────────────────────────────
XmNmwmInputMode -1 CSG
XmCMwmInputMode int
─────────────────────────────────────────────────────────────
XmNmwmMenu NULL CSG
XmCMwmMenu String
─────────────────────────────────────────────────────────────
XmNpreeditType dynamic CSG
XmCPreeditType String
─────────────────────────────────────────────────────────────
XmNshellUnitType XmPIXELS CSG
XmCShellUnitType unsigned char
─────────────────────────────────────────────────────────────
XmNtextFontList dynamic CSG
XmCTextFontList XmFontList
─────────────────────────────────────────────────────────────
XmNuseAsyncGeometry False CSG
XmCUseAsyncGeometry Boolean
─────────────────────────────────────────────────────────────
WMShell Resource Set
────────────────────────────────────────────────────────
Name Default Access
Class Type
────────────────────────────────────────────────────────
────────────────────────────────────────────────────────
XmNbaseHeight XtUnspecifiedShellInt CSG
XmCBaseHeight int
────────────────────────────────────────────────────────
XmNbaseWidth XtUnspecifiedShellInt CSG
XmCBaseWidth int
────────────────────────────────────────────────────────
XmNheightInc XtUnspecifiedShellInt CSG
XmCHeightInc int
────────────────────────────────────────────────────────
XmNiconMask NULL CSG
XmCIconMask Pixmap
────────────────────────────────────────────────────────
XmNiconPixmap NULL CSG
XmCIconPixmap Pixmap
────────────────────────────────────────────────────────
XmNiconWindow NULL CSG
XmCIconWindow Window
────────────────────────────────────────────────────────
XmNiconX -1 CSG
XmCIconX int
────────────────────────────────────────────────────────
XmNiconY -1 CSG
XmCIconY int
────────────────────────────────────────────────────────
XmNinitialState NormalState CSG
XmCInitialState int
────────────────────────────────────────────────────────
XmNinput True CSG
XmCInput Boolean
────────────────────────────────────────────────────────
XmNmaxAspectX XtUnspecifiedShellInt CSG
XmCMaxAspectX int
────────────────────────────────────────────────────────
XmNmaxAspectY XtUnspecifiedShellInt CSG
XmCMaxAspectY int
────────────────────────────────────────────────────────
XmNmaxHeight XtUnspecifiedShellInt CSG
XmCMaxHeight int
────────────────────────────────────────────────────────
XmNmaxWidth XtUnspecifiedShellInt CSG
XmCMaxWidth int
────────────────────────────────────────────────────────
XmNminAspectX XtUnspecifiedShellInt CSG
XmCMinAspectX int
────────────────────────────────────────────────────────
XmNminAspectY XtUnspecifiedShellInt CSG
XmCMinAspectY int
────────────────────────────────────────────────────────
XmNminHeight XtUnspecifiedShellInt CSG
XmCMinHeight int
────────────────────────────────────────────────────────
XmNminWidth XtUnspecifiedShellInt CSG
XmCMinWidth int
────────────────────────────────────────────────────────
XmNtitle dynamic CSG
XmCTitle String
────────────────────────────────────────────────────────
XmNtitleEncoding dynamic CSG
XmCTitleEncoding Atom
────────────────────────────────────────────────────────
XmNtransient True CSG
XmCTransient Boolean
────────────────────────────────────────────────────────
XmNwaitForWm True CSG
XmCWaitForWm Boolean
────────────────────────────────────────────────────────
XmNwidthInc XtUnspecifiedShellInt CSG
XmCWidthInc int
────────────────────────────────────────────────────────
XmNwindowGroup dynamic CSG
XmCWindowGroup Window
────────────────────────────────────────────────────────
XmNwinGravity dynamic CSG
XmCWinGravity int
────────────────────────────────────────────────────────
XmNwmTimeout 5000 ms CSG
XmCWmTimeout int
────────────────────────────────────────────────────────
Shell Resource Set
───────────────────────────────────────────────────────────────────────
Name Default Access
Class Type
───────────────────────────────────────────────────────────────────────
───────────────────────────────────────────────────────────────────────
XmNallowShellResize False CG
XmCAllowShellResize Boolean
───────────────────────────────────────────────────────────────────────
XmNcreatePopupChildProc NULL CSG
XmCCreatePopupChildProc XtCreatePopupChildProc
───────────────────────────────────────────────────────────────────────
XmNgeometry NULL CSG
XmCGeometry String
───────────────────────────────────────────────────────────────────────
XmNoverrideRedirect False CSG
XmCOverrideRedirect Boolean
───────────────────────────────────────────────────────────────────────
XmNpopdownCallback NULL C
XmCCallback XtCallbackList
───────────────────────────────────────────────────────────────────────
XmNpopupCallback NULL C
XmCCallback XtCallbackList
───────────────────────────────────────────────────────────────────────
XmNsaveUnder True CSG
XmCSaveUnder Boolean
───────────────────────────────────────────────────────────────────────
XmNvisual CopyFromParent CSG
XmCVisual Visual *
───────────────────────────────────────────────────────────────────────
Composite Resource Set
──────────────────────────────────────────────────────
Name Default Access
Class Type
──────────────────────────────────────────────────────
──────────────────────────────────────────────────────
XmNchildren NULL G
XmCReadOnly WidgetList
──────────────────────────────────────────────────────
XmNinsertPosition NULL CSG
XmCInsertPosition XtOrderProc
──────────────────────────────────────────────────────
XmNnumChildren 0 G
XmCReadOnly Cardinal
──────────────────────────────────────────────────────
Core Resource Set
─────────────────────────────────────────────────────────────────────
Name Default Access
Class Type
─────────────────────────────────────────────────────────────────────
─────────────────────────────────────────────────────────────────────
XmNaccelerators dynamic CSG
XmCAccelerators XtAccelerators
─────────────────────────────────────────────────────────────────────
XmNancestorSensitive dynamic G
XmCSensitive Boolean
─────────────────────────────────────────────────────────────────────
XmNbackground dynamic CSG
XmCBackground Pixel
─────────────────────────────────────────────────────────────────────
XmNbackgroundPixmap XmUNSPECIFIED_PIXMAP CSG
XmCPixmap Pixmap
─────────────────────────────────────────────────────────────────────
XmNborderColor XtDefaultForeground CSG
XmCBorderColor Pixel
─────────────────────────────────────────────────────────────────────
XmNborderPixmap XmUNSPECIFIED_PIXMAP CSG
XmCPixmap Pixmap
─────────────────────────────────────────────────────────────────────
XmNborderWidth 1 CSG
XmCBorderWidth Dimension
─────────────────────────────────────────────────────────────────────
XmNcolormap dynamic CG
XmCColormap Colormap
─────────────────────────────────────────────────────────────────────
XmNdepth dynamic CG
XmCDepth int
─────────────────────────────────────────────────────────────────────
XmNdestroyCallback NULL C
XmCCallback XtCallbackList
─────────────────────────────────────────────────────────────────────
XmNheight dynamic CSG
XmCHeight Dimension
─────────────────────────────────────────────────────────────────────
XmNinitialResourcesPersistent True C
XmCInitialResourcesPersistent Boolean
─────────────────────────────────────────────────────────────────────
XmNmappedWhenManaged True CSG
XmCMappedWhenManaged Boolean
─────────────────────────────────────────────────────────────────────
XmNscreen dynamic CG
XmCScreen Screen *
─────────────────────────────────────────────────────────────────────
XmNsensitive True CSG
XmCSensitive Boolean
─────────────────────────────────────────────────────────────────────
XmNtranslations dynamic CSG
XmCTranslations XtTranslations
─────────────────────────────────────────────────────────────────────
XmNwidth dynamic CSG
XmCWidth Dimension
─────────────────────────────────────────────────────────────────────
XmNx 0 CSG
XmCPosition Position
─────────────────────────────────────────────────────────────────────
XmNy 0 CSG
XmCPosition Position
─────────────────────────────────────────────────────────────────────
Translations
There are no translations for XmDialogShell.
RELATED INFORMATIONComposite(3X), Core(3X), Shell(3X), TransientShell(3X), WMShell(3X),
VendorShell(3X), and XmCreateDialogShell(3X).
XmDialogShell(3X)