Index Index for
Section 3X
Index Alphabetical
listing for X
Bottom of page Bottom of
page

XmDialogShell(3X)

OSF/Motif

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 BulletinBoard-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 corresponding 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 XmNtransientFor Class: XmCTransientFor Default: NULL Type: Widget Access: CSG VendorShell Resource Set XmNaudibleWarning Class: XmCAudibleWarning Default: XmBELL Type: unsigned char Access: CSG XmNbuttonFontList Class: XmCButtonFontList Default: dynamic Type: XmFontList Access: CSG XmNdefaultFontList Class: XmCDefaultFontList Default: dynamic Type: XmFontList Access: CG XmNdeleteResponse Class: XmCDeleteResponse Default: XmUNMAP Type: unsigned char Access: CSG XmNinputMethod Class: XmCInputMethod Default: NULL Type: String Access: CSG XmNkeyboardFocusPolicy Class: XmCKeyboardFocusPolicy Default: XmEXPLICIT Type: unsigned char Access: CSG XmNlabelFontList Class: XmCLabelFontList Default: dynamic Type: XmFontList Access: CSG XmNmwmDecorations Class: XmCMwmDecorations Default: -1 Type: int Access: CSG XmNmwmFunctions Class: XmCMwmFunctions Default: -1 Type: int Access: CSG XmNmwmInputMode Class: XmCMwmInputMode Default: -1 Type: int Access: CSG XmNmwmMenu Class: XmCMwmMenu Default: NULL Type: String Access: CSG XmNpreeditType Class: XmCPreeditType Default: dynamic Type: String Access: CSG XmNshellUnitType Class: XmCShellUnitType Default: XmPIXELS Type: unsigned char Access: CSG XmNtextFontList Class: XmCTextFontList Default: dynamic Type: XmFontList Access: CSG XmNuseAsyncGeometry Class: XmCUseAsyncGeometry Default: False Type: Boolean Access: CSG WMShell Resource Set XmNbaseHeight Class: XmCBaseHeight Default: XtUnspecifiedShellInt Type: int Access: CSG XmNbaseWidth Class: XmCBaseWidth Default: XtUnspecifiedShellInt Type: int Access: CSG XmNheightInc Class: XmCHeightInc Default: XtUnspecifiedShellInt Type: int Access: CSG XmNiconMask Class: XmCIconMask Default: NULL Type: Pixmap Access: CSG XmNiconPixmap Class: XmCIconPixmap Default: NULL Type: Pixmap Access: CSG XmNiconWindow Class: XmCIconWindow Default: NULL Type: Window Access: CSG XmNiconX Class: XmCIconX Default: -1 Type: int Access: CSG XmNiconY Class: XmCIconY Default: -1 Type: int Access: CSG XmNinitialState Class: XmCInitialState Default: NormalState Type: int Access: CSG XmNinput Class: XmCInput Default: True Type: Boolean Access: CSG XmNmaxAspectX Class: XmCMaxAspectX Default: XtUnspecifiedShellInt Type: int Access: CSG XmNmaxAspectY Class: XmCMaxAspectY Default: XtUnspecifiedShellInt Type: int Access: CSG XmNmaxHeight Class: XmCMaxHeight Default: XtUnspecifiedShellInt Type: int Access: CSG XmNmaxWidth Class: XmCMaxWidth Default: XtUnspecifiedShellInt Type: int Access: CSG XmNminAspectX Class: XmCMinAspectX Default: XtUnspecifiedShellInt Type: int Access: CSG XmNminAspectY Class: XmCMinAspectY Default: XtUnspecifiedShellInt Type: int Access: CSG XmNminHeight Class: XmCMinHeight Default: XtUnspecifiedShellInt Type: int Access: CSG XmNminWidth Class: XmCMinWidth Default: XtUnspecifiedShellInt Type: int Access: CSG XmNtitle Class: XmCTitle Default: dynamic Type: String Access: CSG XmNtitleEncoding Class: XmCTitleEncoding Default: dynamic Type: Atom Access: CSG XmNtransient Class: XmCTransient Default: True Type: Boolean Access: CSG XmNwaitForWm Class: XmCWaitForWm Default: True Type: Boolean Access: CSG XmNwidthInc Class: XmCWidthInc Default: XtUnspecifiedShellInt Type: int Access: CSG XmNwindowGroup Class: XmCWindowGroup Default: dynamic Type: Window Access: CSG XmNwinGravity Class: XmCWinGravity Default: dynamic Type: int Access: CSG XmNwmTimeout Class: XmCWmTimeout Default: 5000 ms Type: int Access: CSG Shell Resource Set XmNallowShellResize Class: XmCAllowShellResize Default: False Type: Boolean Access: CG XmNcreatePopupChildProc Class: XmCCreatePopupChildProc Default: NULL Type: XtCreatePopupChildProc Access: CSG XmNgeometry Class: XmCGeometry Default: NULL Type: String Access: CSG XmNoverrideRedirect Class: XmCOverrideRedirect Default: False Type: Boolean Access: CSG XmNpopdownCallback Class: XmCCallback Default: NULL Type: XtCallbackList Access: C XmNpopupCallback Class: XmCCallback Default: NULL Type: XtCallbackList Access: C XmNsaveUnder Class: XmCSaveUnder Default: True Type: Boolean Access: CSG XmNvisual Class: XmCVisual Default: CopyFromParent Type: Visual * Access: CSG Composite Resource Set XmNchildren Class: XmCReadOnly Default: NULL Type: WidgetList Access: G XmNinsertPosition Class: XmCInsertPosition Default: NULL Type: XtOrderProc Access: CSG XmNnumChildren Class: XmCReadOnly Default: 0 Type: Cardinal Access: G Core Resource Set XmNaccelerators Class: XmCAccelerators Default: dynamic Type: XtAccelerators Access: CSG XmNancestorSensitive Class: XmCSensitive Default: dynamic Type: Boolean Access: G XmNbackground Class: XmCBackground Default: dynamic Type: Pixel Access: CSG XmNbackgroundPixmap Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap Access: CSG XmNborderColor Class: XmCBorderColor Default: XtDefaultForeground Type: Pixel Access: CSG XmNborderPixmap Class: XmCPixmap Default: XmUNSPECIFIED_PIXMAP Type: Pixmap Access: CSG XmNborderWidth Class: XmCBorderWidth Default: 1 Type: Dimension Access: CSG XmNcolormap Class: XmCColormap Default: dynamic Type: Colormap Access: CG XmNdepth Class: XmCDepth Default: dynamic Type: int Access: CG XmNdestroyCallback Class: XmCCallback Default: NULL Type: XtCallbackList Access: C XmNheight Class: XmCHeight Default: dynamic Type: Dimension Access: CSG XmNinitialResourcesPersistent Class: XmCInitialResourcesPersistent Default: True Type: Boolean Access: C XmNmappedWhenManaged Class: XmCMappedWhenManaged Default: True Type: Boolean Access: CSG XmNscreen Class: XmCScreen Default: dynamic Type: Screen * Access: CG XmNsensitive Class: XmCSensitive Default: True Type: Boolean Access: CSG XmNtranslations Class: XmCTranslations Default: dynamic Type: XtTranslations Access: CSG XmNwidth Class: XmCWidth Default: dynamic Type: Dimension Access: CSG XmNx Class: XmCPosition Default: 0 Type: Position Access: CSG XmNy Class: XmCPosition Default: 0 Type: Position 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)

Index Index for
Section 3X
Index Alphabetical
listing for X
Top of page Top of
page