XmDialogShell(3X)

XmDialogShell --The DialogShell widget class

As shipped in IRIX 6.5.19. Unchanged since IRIX 6.5.

NAME
     XmDialogShell --The DialogShell widget class

SYNOPSIS
     #include <Xm/DialogS.h>


VERSION
     This page documents version 1.2 of the Motif library.

DESCRIPTION
     Modal  and  modeless  dialogs  use  DialogShell  as  the Shell parent.  Di-
     alogShell 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  inter-
     faces during creation, and it can directly manipulate its BulletinBoard-de-
     rived  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 in-
     side 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 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 program-
     mer 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 re-
     maining letters (in either lowercase or uppercase, but include  any  under-
     scores  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              Class             Type     Default   Access
           --------------------------------------------------------------
           XmNtransientFor   XmCTransientFor   Widget   NULL      CSG

                              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   XmUNMAP      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 XmDialogShell.

RELATED INFORMATION
     Composite(3X), Core(3X), Shell(3X), TransientShell(3X), WMShell(3X), Ven-
     dorShell(3X), and XmCreateDialogShell(3X).

                                                               XmDialogShell(3X)