Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ XmDialoSh(Xm) — OpenDesktop Software Development System 3.0.0

Media Vault

Software Library

Restoration Projects

Artifacts Sought


 XmDialogShell(Xm)              6 January 1993              XmDialogShell(Xm)


 Name

    XmDialogShell - the DialogShell widget class

 Syntax


    #include <Xm/DialogS.h>


 Description

    Modal and modeless dialogs use DialogShell as the Shell parent.  Dialog-
    Shell 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-
    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 win-
    dow 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 superc-
    lasses. 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 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

 ____________________________________________________________________________
 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
 XmNkeyboardFocus-   XmCKeyboardFocus-   unsigned       char       XmEXPLICIT
 Policy              Policy
 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
 XmNuseAsync-        XmCUseAsync-        Boolean        False      CSG
 Geometry            Geometry


 TransientShell resource set

 ____________________________________________________________________________
 Name                 Class                 Type         Default       Access
 ____________________________________________________________________________
 XmNtransientFor      XmCTransientFor       Widget       NULL          CSG


 WMShell resource set

 ____________________________________________________________________________
 Name                Class               Type         Default          Access
 ____________________________________________________________________________
 XmNbaseHeight       XmCBaseHeight       int          XtUnspecified-   CSG
                                                      ShellInt
 XmNbaseWidth        XmCBaseWidth        int          XtUnspecified-   CSG
                                                      ShellInt
 XmNheightInc        XmCHeightInc        int          XtUnspecified-   CSG
                                                      ShellInt
 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          XtUnspecified-   CSG
                                                      ShellInt
 XmNmaxAspectY       XmCMaxAspectY       int          XtUnspecified-   CSG
                                                      ShellInt
 XmNmaxHeight        XmCMaxHeight        int          XtUnspecified-   CSG
                                                      ShellInt
 XmNmaxWidth         XmCMaxWidth         int          XtUnspecified-   CSG
                                                      ShellInt
 XmNminAspectX       XmCMinAspectX       int          XtUnspecified-   CSG
                                                      ShellInt
 XmNminAspectY       XmCMinAspectY       int          XtUnspecified-   CSG
                                                      ShellInt
 XmNminHeight        XmCMinHeight        int          XtUnspecified-   CSG
                                                      ShellInt
 XmNminWidth         XmCMinWidth         int          XtUnspecified-   CSG
                                                      ShellInt
 XmNtitle            XmCTitle            String       dynamic          CSG
 XmNtitleEncoding    XmCTitleEncoding    Atom         dynamic          CSG
 XmNtransient        XmCTransient        Boolean      True             CSG
 XmNwaitForWm        XmCWaitForWm        Boolean      True             CSG
 XmNwidthInc         XmCWidthInc         int          XtUnspecified-   CSG
                                                      ShellInt
 XmNwindowGroup      XmCWindowGroup      Window       dynamic          CSG
 XmNwinGravity       XmCWinGravity       int          dynamic          CSG
 XmNwmTimeout        XmCWmTimeout        int          5000 ms          CSG


 Shell resource set

 ____________________________________________________________________________
 Name                Class             Type            Default         Access
 ____________________________________________________________________________
 XmNal-              XmCAl-            Boolean         False           CG
 lowShellResize      lowShellResize
 XmNcreatePopup-     XmCCreatePopup-   XtCreatePopup-  NULL            CSG
 ChildProc           ChildProc         ChildProc
 XmNgeometry         XmCGeometry       String          NULL            CSG
 XmNoverride-        XmCOverride-      Boolean         False           CSG
 Redirect            Redirect
 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
 XmNancestor-        XmCSensitive       Boolean        dynamic         G
 Sensitive
 XmNbackground       XmCBackground      Pixel          dynamic         CSG
 XmNbackground-      XmCPixmap          Pixmap         XmUNSPECIFIED_- CSG
 Pixmap                                                PIXMAP
 XmNborderColor      XmCBorderColor     Pixel          XtDefault-      CSG
                                                       Foreground
 XmNborderPixmap     XmCPixmap          Pixmap         XmUNSPECIFIED_- CSG
                                                       PIXMAP
 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
 XmNinitial-         XmCInitial-        Boolean        True            C
 ResourcesPersistent ResourcesPersistent
 XmNmappedWhen-      XmCMappedWhen-     Boolean        True            CSG
 Managed             Managed
 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.

 See also

    Composite(Xm), Core(Xm), Shell(Xm), TransientShell(Xm), WMShell(Xm),
    VendorShell(Xm) and XmCreateDialogShell(Xm).



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026