


                                                                   Object(3X)



   NAME
     OObbjjeecctt-The Object widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>

   DESCRIPTION
     Object is never instantiated.  Its sole purpose is as a supporting
     superclass for other widget classes.

     Classes

     The class pointer is oobbjjeeccttCCllaassss.

     The class name is OObbjjeecctt.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                               OObbjjeecctt RReessoouurrccee SSeett
       NNaammee                 CCllaassss         TTyyppee             DDeeffaauulltt   AAcccceessss
       ____________________________________________________________________
       XmNdestroyCallback   XmCCallback   XtCallbackList   NULL      C

     XXmmNNddeessttrrooyyCCaallllbbaacckk
               Specifies a list of callbacks that is called when the gadget
               is destroyed.















   2-75






   OverrideShell(3X)



   NAME
     OOvveerrrriiddeeSShheellll-The OverrideShell widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     OverrideShell is used for shell windows that completely bypass the win-
     dow manager, for example, PopupMenu shells.

     Classes

     OverrideShell inherits behavior and resources from CCoorree, CCoommppoossiittee, and
     SShheellll.

     The class pointer is oovveerrrriiddeeSShheellllWWiiddggeettCCllaassss.

     The class name is OOvveerrrriiddeeSShheellll.

     New Resources

     OverrideShell defines no new resources, but overrides the XXmmNNoovveerrrrii--
     ddeeRReeddiirreecctt and XXmmNNssaavveeUUnnddeerr resources in the SShheellll class.

     Inherited Resources

     OverrideShell 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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  True             CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C


   2-76






                                                            OverrideShell(3X)


   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  True             CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), and SShheellll((33XX)).






















   2-77






   RectObj(3X)



   NAME
     RReeccttOObbjj-The RectObj widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>

   DESCRIPTION
     RectObj is never instantiated.  Its sole purpose is as a supporting
     superclass for other widget classes.

     Classes

     RectObj inherits behavior and a resource from OObbjjeecctt.

     The class pointer is rreeccttOObbjjCCllaassss.

     The class name is RReeccttOObbjj.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                               RReeccttOObbjj RReessoouurrccee SSeett
       NNaammee                   CCllaassss            TTyyppee        DDeeffaauulltt   AAcccceessss
       ____________________________________________________________________
       XmNancestorSensitive   XmCSensitive     Boolean     dynamic   G
       XmNborderWidth         XmCBorderWidth   Dimension   1         CSG
       XmNheight              XmCHeight        Dimension   dynamic   CSG
       XmNsensitive           XmCSensitive     Boolean     True      CSG
       XmNwidth               XmCWidth         Dimension   dynamic   CSG
       XmNx                   XmCPosition      Position    0         CSG
       XmNy                   XmCPosition      Position    0         CSG











   2-78






                                                                  RectObj(3X)



     XXmmNNaanncceessttoorrSSeennssiittiivvee
               Specifies whether the immediate parent of the gadget receives
               input events.  Use the function XXttSSeettSSeennssiittiivvee if you are
               changing the argument to preserve data integrity (see XXmmNNsseenn--
               ssiittiivvee below).  The default is the bitwise AND of the parent's
               XXmmNNsseennssiittiivvee and XXmmNNaanncceessttoorrSSeennssiittiivvee resources.

     XXmmNNbboorrddeerrWWiiddtthh
               Specifies the width of the border placed around the RectObj's
               rectangular display area.

     XXmmNNhheeiigghhtt Specifies the inside height (excluding the border) of the
               RectObj's rectangular display area.

     XXmmNNsseennssiittiivvee
               Determines whether a RectObj receives input events.  If a Rec-
               tObj is sensitive, the parent dispatches to the gadget all
               keyboard, mouse button, motion, window enter/leave, and focus
               events.  Insensitive gadgets do not receive these events.  Use
               the function XXttSSeettSSeennssiittiivvee to change the sensitivity argu-
               ment.  Using XXttSSeettSSeennssiittiivvee ensures that if a parent widget
               has XXmmNNsseennssiittiivvee set to False, the ancestor-sensitive flag of
               all its children is appropriately set.

     XXmmNNwwiiddtthh  Specifies the inside width (excluding the border) of the
               RectObj's rectangular display area.

     XXmmNNxx      Specifies the x-coordinate of the upper left outside corner of
               the RectObj's rectangular display area.  The value is relative
               to the upper left inside corner of the parent window.

     XXmmNNyy      Specifies the y-coordinate of the upper left outside corner of
               the RectObj's rectangular display area.  The value is relative
               to the upper left inside corner of the parent window.

     Inherited Resources

     RectObj inherits behavior and a resource from OObbjjeecctt.  For a description
     of this resource, refer to the OObbjjeecctt man page.
                               OObbjjeecctt RReessoouurrccee SSeett
       NNaammee                 CCllaassss         TTyyppee             DDeeffaauulltt   AAcccceessss
       ____________________________________________________________________
       XmNdestroyCallback   XmCCallback   XtCallbackList   NULL      C

   RELATED INFORMATION
     OObbjjeecctt((33XX)).









   2-79






   Shell(3X)



   NAME
     SShheellll-The Shell widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     Shell is a top-level widget (with only one managed child) that encapsu-
     lates the interaction with the window manager.

     At the time the shell's child is managed, the child's width is used for
     both widgets if the shell is unrealized and no width has been specified
     for the shell.  Otherwise, the shell's width is used for both widgets.
     The same relations hold for the height of the shell and its child.

     Classes

     Shell inherits behavior and resources from CCoommppoossiittee and CCoorree.

     The class pointer is sshheellllWWiiddggeettCCllaassss.

     The class name is SShheellll.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG

     XXmmNNaalllloowwSShheellllRReessiizzee


   2-80






                                                                    Shell(3X)


               Specifies that if this resource is False, the Shell widget
               instance returns XXttGGeeoommeettrryyNNoo to all geometry requests from
               its children.

     XXmmNNccrreeaatteePPooppuuppCChhiillddPPrroocc
               Specifies the pointer to a function that is called when the
               Shell widget instance is popped up by XXttPPooppuupp.  The function
               creates the child widget when the shell is popped up instead
               of when the application starts up.  This can be used if the
               child needs to be reconfigured each time the shell is popped
               up.  The function takes one argument, the popup shell, and
               returns no result.  It is called after the popup callbacks
               specified by XXmmNNppooppuuppCCaallllbbaacckk.

     XXmmNNggeeoommeettrryy
               Specifies the desired geometry for the widget instance.  This
               resource is examined only when the widget instance is unreal-
               ized and the number of its managed children is changed.  It is
               to change the values of the XXmmNNxx, XXmmNNyy, XXmmNNwwiiddtthh, and
               XXmmNNhheeiigghhtt resources.

     XXmmNNoovveerrrriiddeeRReeddiirreecctt
               Specifies this is True if the widget instance is a temporary
               window which should be ignored by the window manager.  Appli-
               cations and users should not normally alter this resource.

     XXmmNNppooppddoowwnnCCaallllbbaacckk
               Specifies a list of callbacks that is called when the widget
               instance is popped down by XXttPPooppddoowwnn.

     XXmmNNppooppuuppCCaallllbbaacckk
               Specifies a list of callbacks that is called when the widget
               instance is popped up by XXttPPooppuupp.

     XXmmNNssaavveeUUnnddeerr
               Specifies a True value if it is desirable to save the contents
               of the screen beneath this widget instance, avoiding expose
               events when the instance is unmapped.  This is a hint, and an
               implementation may save contents whenever it desires, includ-
               ing always or never.

     XXmmNNvviissuuaall Specifies the visual used in creating the widget.














   2-81






   Shell(3X)



     Inherited Resources

     Shell inherits behavior and resources from the following superclass.
     For a complete description of each resource, refer to the man page for
     that superclass.
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)) and CCoorree((33XX)).



















   2-82






                                                            TopLevelShell(3X)



   NAME
     TTooppLLeevveellSShheellll-The TopLevelShell widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     TopLevelShell is used for normal top-level windows such as any addi-
     tional top-level widgets an application needs.

     Classes

     TopLevelShell inherits behavior and resources from CCoorree, CCoommppoossiittee,
     SShheellll, WWMMSShheellll, and VVeennddoorrSShheellll.

     The class pointer is ttooppLLeevveellSShheellllWWiiddggeettCCllaassss.

     The class name is TTooppLLeevveellSShheellll.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                            TTooppLLeevveellSShheellll RReessoouurrccee SSeett
      NNaammee                  CCllaassss                 TTyyppee      DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNiconic             XmCIconic             Boolean   False     CSG
      XmNiconName           XmCIconName           String    NULL      CSG
      XmNiconNameEncoding   XmCIconNameEncoding   Atom      dynamic   CSG

     XXmmNNiiccoonniicc Specifies that if this is True when the widget instance is
               realized, the widget instance indicates to the window manager
               that the application wishes to start as an icon, irrespective
               of the XXmmNNiinniittiiaallSSttaattee resource.

     XXmmNNiiccoonnNNaammee
               Specifies the short form of the application name to be
               displayed by the window manager when the application is iconi-
               fied.



   2-83






   TopLevelShell(3X)


     XXmmNNiiccoonnNNaammeeEEnnccooddiinngg
               Specifies a property type that represents the encoding of the
               XXmmNNiiccoonnNNaammee string.  If a language procedure has been set, the
               default is None; otherwise, the default is XA_STRING.  When
               the widget is realized, if the value is None, the correspond-
               ing name is assumed to be in the current locale.  The name is
               passed to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an encoding style of
               XXSSttddIICCCCTTeexxttSSttyyllee.  The resulting encoding is "STRING" if the
               name is fully convertible to "STRING," otherwise
               "COMPOUND_TEXT."  The values of the encoding resources are not
               changed; they remain None.

     Inherited Resources

     TopLevelShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    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
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   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   False                   CSG


   2-84






                                                            TopLevelShell(3X)


   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
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), WWMMSShheellll((33XX)), and VVeennddoorrSShheellll((33XX)).









   2-85






   TransientShell(3X)



   NAME
     TTrraannssiieennttSShheellll-The TransientShell widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     TransientShell is used for shell windows that can be manipulated by the
     window manager but are not allowed to be iconified separately.  For
     example, Dialog boxes make no sense without their associated applica-
     tion.  They are iconified by the window manager only if the main appli-
     cation shell is iconified.

     Classes

     TransientShell inherits behavior and resources from CCoorree, CCoommppoossiittee,
     SShheellll, WWMMSShheellll, and VVeennddoorrSShheellll.

     The class pointer is ttrraannssiieennttSShheellllWWiiddggeettCCllaassss.

     The class name is TTrraannssiieennttSShheellll.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).

     In addition to these new resources, new resources, TTrraannssiieennttSShheellll over-
     rides the XXmmNNssaavveeUUnnddeerr resource in SShheellll and the XXmmNNttrraannssiieenntt resource
     in WWMMSShheellll.
                           TTrraannssiieennttSShheellll RReessoouurrccee SSeett
          NNaammee              CCllaassss             TTyyppee     DDeeffaauulltt   AAcccceessss
          _____________________________________________________________
          XmNtransientFor   XmCTransientFor   Widget   NULL      CSG

     XXmmNNttrraannssiieennttFFoorr
               Specifies a widget for which the shell acts as a pop-up.  If
               this resource is NULL or is a widget that has not been real-
               ized, the XXmmNNwwiinnddoowwGGrroouupp is used instead.



   2-86






                                                           TransientShell(3X)



     Inherited Resources

     TransientShell 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 attri-
     butes for this widget.  To reference a resource by name or by class in a
     .Xdefaults file, remove the XXmmNN or XXmmCC prefix and use the remaining
     letters.  To specify one of the defined values for a resource in a .Xde-
     faults file, remove the XXmm 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 XXttSSeettVVaalluueess (S), retrieved
     by using XXttGGeettVVaalluueess (G), or is not applicable (N/A).
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    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
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   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


   2-87






   TransientShell(3X)


   XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
   XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
   XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
   XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), VVeennddoorrSShheellll((33XX)), and WWMMSShheellll((33XX)).










   2-88






                                                                      Uil(3X)



   NAME
     UUiill-Invokes the UIL compiler from within an application

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<uuiill//UUiillDDeeff..hh>>
     UUiill__ssttaattuuss__ttyyppee UUiill ((_c_o_m_m_a_n_d__d_e_s_c, _c_o_m_p_i_l_e__d_e_s_c, _m_e_s_s_a_g_e__c_b,
               _m_e_s_s_a_g_e__d_a_t_a, _s_t_a_t_u_s__c_b, _s_t_a_t_u_s__d_a_t_a))
          UUiill__ccoommmmaanndd__ttyyppee    *_c_o_m_m_a_n_d__d_e_s_c;;
          UUiill__ccoommppiillee__ddeesscc__ttyyppee*_c_o_m_p_i_l_e__d_e_s_c;;
          UUiill__ccoonnttiinnuuee__ttyyppee   ((*_m_e_s_s_a_g_e__c_b)) (());;
          cchhaarr                *_m_e_s_s_a_g_e__d_a_t_a;;
          UUiill__ccoonnttiinnuuee__ttyyppee   ((*_s_t_a_t_u_s__c_b)) (());;
          cchhaarr                *_s_t_a_t_u_s__d_a_t_a;;

   DESCRIPTION
     The UUiill function provides a callable entry point for the UIL compiler.
     The UUiill callable interface can be used to process a UIL source file and
     to generate UID files, as well as return a detailed description of the
     UIL source module in the form of a symbol table (parse tree).

     _c_o_m_m_a_n_d__d_e_s_c        Specifies the uuiill command line.

     _c_o_m_p_i_l_e__d_e_s_c        Returns the results of the compilation.

     _m_e_s_s_a_g_e__c_b          Specifies a callback function that is called when
                         the compiler encounters errors in the UIL source.

     _m_e_s_s_a_g_e__d_a_t_a        Specifies user data that is passed to the message
                         callback function (message_cb). Note that this argu-
                         ment is not interpreted by UIL, and is used
                         exclusively by the calling application.

     _s_t_a_t_u_s__c_b           Specifies a callback function that is called to
                         allow X applications to service X events such as
                         updating the screen.  This function is called at
                         various check points, which have been hard coded
                         into the UIL compiler.  The status_update_delay
                         argument in command_desc specifies the number of
                         check points to be passed before the status_cb func-
                         tion is invoked.

     _s_t_a_t_u_s__d_a_t_a         Specifies user data that is passed to the status
                         callback function (status_cb). Note that this argu-
                         ment is not interpreted by the UIL compiler, and is
                         used exclusively by the calling application.

     The data structures UUiill__ccoommmmaanndd__ttyyppee and UUiill__ccoommppiillee__ddeesscc__ttyyppee are
     detailed below.
     typedef struct Uil_command_type {
     char *source_file;


   2-89






   Uil(3X)


         /* single source to compile */
     char *resource_file; /* name of output file */
     char *listing_file; /* name of listing file */
     unsigned int *include_dir_count;
         /* number of dirs. in include_dir */
     char *((*include_dir) []);
         /* dir. to search for include files */
     unsigned listing_file_flag: 1;
         /* produce a listing */
     unsigned resource_file_flag: 1;
         /* generate UID output */
     unsigned machine_code_flag: 1;
         /* generate machine code */
     unsigned report_info_msg_flag: 1;
         /* report info messages */
     unsigned report_warn_msg_flag: 1;
         /* report warnings */
     unsigned parse_tree_flag: 1;
         /* generate parse tree */
     unsigned int status_update_delay;
         /* number of times a status point is */
         /* passed before calling status_cb */
         /* function 0 means called every time */
     };

     typedef struct Uil_compile_desc_type {
     unsigned int compiler_version;
         /* version number of compiler */
     unsigned int data_version;
         /* version number of structures */
     char *parse_tree_root; /* parse tree output */
     unsigned int message_count [Uil_k_max_status+1];
     /* array of severity counts */
     };






















   2-90






                                                                      Uil(3X)


     Following is a description of the message callback function specified by
     _m_e_s_s_a_g_e__c_b:
     UUiill__ccoonnttiinnuuee__ttyyppee ((*_m_e_s_s_a_g_e__c_b)) ((_m_e_s_s_a_g_e__d_a_t_a, _m_e_s_s_a_g_e__n_u_m_b_e_r,
               _s_e_v_e_r_i_t_y, _m_s_g__b_u_f_f_e_r, _s_r_c__b_u_f_f_e_r, _p_t_r__b_u_f_f_e_r, _l_o_c__b_u_f_f_e_r,
               _m_e_s_s_a_g_e__c_o_u_n_t))
          cchhaarr      *_m_e_s_s_a_g_e__d_a_t_a;;
          iinntt       _m_e_s_s_a_g_e__n_u_m_b_e_r;;
          iinntt       _s_e_v_e_r_i_t_y;;
          cchhaarr      *_m_s_g__b_u_f_f_e_r,, *_s_r_c__b_u_f_f_e_r;;
          cchhaarr      *_p_t_r__b_u_f_f_e_r,, *_l_o_c__b_u_f_f_e_r;;
          iinntt       _m_e_s_s_a_g_e__c_o_u_n_t[[]];;

     Specifies a callback function that UIL invokes instead of printing an
     error message when the compiler encounters an error in the UIL source.
     The callback should return one of these values:

     UUiill__kk__tteerrmmiinnaattee     Tells UIL to terminate processing of the source
                         file.

     UUiill__kk__ccoonnttiinnuuee      Tells UIL to continue processing the source file.

     Following are the arguments:

     _m_e_s_s_a_g_e__d_a_t_a        Data supplied by the application as the _m_e_s_s_a_g_e__d_a_t_a
                         argument to the UUiill function.  UIL does not inter-
                         pret this data in any way; it just passes it to the
                         callback.

     _m_e_s_s_a_g_e__n_u_m_b_e_r      An index into a table of error messages and severi-
                         ties, for internal use by UIL.

     _s_e_v_e_r_i_t_y            An integer that indicates the severity of the error.
                         The possible values are the status constants
                         returned by the UUiill function.  See the "RETURN
                         VALUE" section below.

     _m_s_g__b_u_f_f_e_r          A string that describes the error.

     _s_r_c__b_u_f_f_e_r          A string consisting of the source line where the
                         error occurred.  This is not always available; the
                         argument is then NULL.

     _p_t_r__b_u_f_f_e_r          A string consisting of whitespace and a printing
                         character in the character position corresponding to
                         the column of the source line where the error
                         occurred.  This string may be printed beneath the
                         source line to provide a visual indication of the
                         column where the error occurred.  This is not always
                         available; the argument is then NULL.

     _l_o_c__b_u_f_f_e_r          A string identifying the line number and file of the
                         source line where the error occurred.  This is not
                         always available; the argument is then NULL.



   2-91






   Uil(3X)


     _m_e_s_s_a_g_e__c_o_u_n_t       An array of integers containing the number of diag-
                         nostic messages issued thus far for each severity
                         level.  To find the number of messages issued for
                         the current severity level, use the _s_e_v_e_r_i_t_y argu-
                         ment as the index into this array.

     Following is a description of the status callback function specified by
     _s_t_a_t_u_s__c_b:
     UUiill__ccoonnttiinnuuee__ttyyppee ((*_s_t_a_t_u_s__c_b)) ((_s_t_a_t_u_s__d_a_t_a, _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e,
               _l_i_n_e_s__p_r_o_c_e_s_s_e_d, _c_u_r_r_e_n_t__f_i_l_e, _m_e_s_s_a_g_e__c_o_u_n_t))
          cchhaarr      *_s_t_a_t_u_s__d_a_t_a;;
          iinntt       _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e;;
          iinntt       _l_i_n_e_s__p_r_o_c_e_s_s_e_d;;
          cchhaarr      *_c_u_r_r_e_n_t__f_i_l_e;;
          iinntt       _m_e_s_s_a_g_e__c_o_u_n_t[[]];;

     Specifies a callback function that is invoked to allow X applications to
     service X events such as updating the screen.  The callback should
     return one of these values:

     UUiill__kk__tteerrmmiinnaattee     Tells UIL to terminate processing of the source
                         file.

     UUiill__kk__ccoonnttiinnuuee      Tells UIL to continue processing the source file.

     Following are the arguments:

     _s_t_a_t_u_s__d_a_t_a         Data supplied by the application as the _s_t_a_t_u_s__d_a_t_a
                         argument to the UUiill function.  UIL does not inter-
                         pret this data in any way; it just passes it to the
                         callback.

     _p_e_r_c_e_n_t__c_o_m_p_l_e_t_e    An integer indicating what percentage of the current
                         source file has been processed so far.

     _l_i_n_e_s__p_r_o_c_e_s_s_e_d     An integer indicating how many lines of the current
                         source file have been read so far.

     _c_u_r_r_e_n_t__f_i_l_e        A string containing the pathname of the current
                         source file.

     _m_e_s_s_a_g_e__c_o_u_n_t       An array of integers containing the number of diag-
                         nostic messages issued thus far for each severity
                         level.  To find the number of messages issued for a
                         given severity level, use the severity level as the
                         index into this array.  The possible severity levels
                         are the status constants returned by the UUiill func-
                         tion.  See the "RETURN VALUE" section below.

   RETURN VALUE
     This function returns one of these status return constants:

     UUiill__kk__ssuucccceessss__ssttaattuuss     The operation succeeded.



   2-92






                                                                      Uil(3X)


     UUiill__kk__iinnffoo__ssttaattuuss        The operation succeeded, and an informational
                              message is returned.

     UUiill__kk__wwaarrnniinngg__ssttaattuuss     The operation succeeded, and a warning message
                              is returned.

     UUiill__kk__eerrrroorr__ssttaattuuss       The operation failed due to an error.

     UUiill__kk__sseevveerree__ssttaattuuss      The operation failed due to an error.















































   2-93






   VendorShell(3X)



   NAME
     VVeennddoorrSShheellll-The VendorShell widget class

   AES SUPPORT LEVEL
     Full-use

   HISTORY/DIRECTION
     The description of the geometry management of shells and their children
     has been changed (for Trial-use).  New resources have been added speci-
     fying font lists for button, label, and text children (for Trial-use).

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     VendorShell is a Motif widget class used as a supporting superclass for
     all shell classes that are visible to the window manager and that are
     not override redirect.  It contains resources that describe the MWM-
     specific look and feel.  It also manages the MWM-specific communication
     needed by all VendorShell subclasses.  See the mmwwmm(1X) man page for more
     information.

     Setting XXmmNNhheeiigghhtt, XXmmNNwwiiddtthh, or XXmmNNbboorrddeerrWWiiddtthh for either a VendorShell
     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 XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the shell does not necessarily
     set that resource to the same value in the managed child, and setting
     XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the child does not necessarily set that
     resource to the same value in the shell.

     For the managed child of a VendorShell, regardless of the value of the
     shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or XXmmNNyy sets the corresponding
     resource of the parent but does not change the child's position relative
     to the parent.  XXttGGeettVVaalluueess for the child's XXmmNNxx or XXmmNNyy yields the
     value of the corresponding resource in the parent.  The _x and _y coordi-
     nates of the child's upper left outside corner relative to the parent's
     upper left inside corner are both zero minus the value of XXmmNNbboorr--
     ddeerrWWiiddtthh.

     Note that the _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l allows a
     window manager to change or control the border width of a reparented
     top-level window.

     Classes

     VendorShell inherits behavior and resources from CCoorree, CCoommppoossiittee, SShheellll,
     and WWMMSShheellll classes.

     The class pointer is vveennddoorrSShheellllWWiiddggeettCCllaassss.



   2-94






                                                              VendorShell(3X)


     The class name is VVeennddoorrSShheellll.

     New Resources

     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 subresource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a subresource in a .Xdefaults file, remove the XXmm
     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 subresource can be set at creation time
     (C), set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G),
     or is not applicable (N/A).
                                 VVeennddoorrSShheellll RReessoouurrccee SSeett
   NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
   _____________________________________________________________________________________
   XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
   XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
   XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmDESTROY    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
   XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG

     XXmmNNbbuuttttoonnFFoonnttLLiisstt
               Specifies the font list used for VendorShell's button descen-
               dants.  If this value is NULL at initialization and if the
               value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is
               initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the value
               of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initial-
               ized by looking up the parent hierarchy of the widget for an
               ancestor that is a subclass of the XmBulletinBoard, Vendor-
               Shell, or XmMenuShell widget class.  If such an ancestor is
               found, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initialized to the XXmmNNbbuuttttoonn--
               FFoonnttLLiisstt of the ancestor  widget.  If no such ancestor is
               found, the default is implementation dependent.

     XXmmNNddeeffaauullttFFoonnttLLiisstt
               Specifies a default font list for VendorShell's descendants.
               This resource is obsolete and exists for compatibility with
               earlier releases.  It has been replaced by XXmmNNbbuuttttoonnFFoonnttLLiisstt,
               XXmmNNllaabbeellFFoonnttLLiisstt, and XXmmNNtteexxttFFoonnttLLiisstt.

     XXmmNNddeelleetteeRReessppoonnssee
               Determines what action the shell takes in response to a
               WWMM__DDEELLEETTEE__WWIINNDDOOWW message.  The setting can be one of three
               values: XXmmDDEESSTTRROOYY, XXmmUUNNMMAAPP, and XXmmDDOO__NNOOTTHHIINNGG.  The resource is
               scanned, and the appropriate action is taken, after the
               WWMM__DDEELLEETTEE__WWIINNDDOOWW callback list (if any) that is registered


   2-95






   VendorShell(3X)


               with the Protocol manager has been called.

     XXmmNNkkeeyybbooaarrddFFooccuussPPoolliiccyy
               Determines allocation of keyboard focus within the widget
               hierarchy rooted at this shell.  The X keyboard focus must be
               directed to somewhere in the hierarchy for this client-side
               focus management to take effect.  Possible values are XXmmEEXXPPLLII--
               CCIITT, specifying a click-to-type policy, and XXmmPPOOIINNTTEERR, speci-
               fying a pointer-driven policy.

     XXmmNNllaabbeellFFoonnttLLiisstt
               Specifies the font list used for VendorShell's label descen-
               dants (Labels and LabelGadgets).  If this value is NULL at
               initialization and if the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not
               NULL, XXmmNNllaabbeellFFoonnttLLiisstt is initialized to the value of XXmmNNddee--
               ffaauullttFFoonnttLLiisstt.  If the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL,
               XXmmNNllaabbeellFFoonnttLLiisstt is initialized by looking up the parent
               hierarchy of the widget for an ancestor that is a subclass of
               the XmBulletinBoard, VendorShell, or XmMenuShell widget class.
               If such an ancestor is found, XXmmNNllaabbeellFFoonnttLLiisstt is initialized
               to the XXmmNNllaabbeellFFoonnttLLiisstt of the ancestor widget.  If no such
               ancestor is found, the default is implementation dependent.

     XXmmNNmmwwmmDDeeccoorraattiioonnss
               Specifies the decoration flags (specific decorations to add or
               remove from the window manager frame) for the __MMOOTTIIFF__WWMM__HHIINNTTSS
               property.  If any decoration flags are specified by the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property, only decorations indicated by both
               that property and the MWM cclliieennttDDeeccoorraattiioonn and ttrraann--
               ssiieennttDDeeccoorraattiioonn resources are displayed.  If no decoration
               flags are specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, decora-
               tions indicated by the MWM cclliieennttDDeeccoorraattiioonn and ttrraann--
               ssiieennttDDeeccoorraattiioonn resources are displayed.  The default for the
               XXmmNNmmwwmmDDeeccoorraattiioonnss resource is not to specify any decoration
               flags for the __MMOOTTIIFF__WWMM__HHIINNTTSS property.

     XXmmNNmmwwmmFFuunnccttiioonnss
               Specifies the function flags (specific window manager func-
               tions to apply or not apply to the client window) for the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property.  If any function flags are specified
               by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, only functions indicated by
               both that property and the MWM cclliieennttFFuunnccttiioonnss and ttrraann--
               ssiieennttFFuunnccttiioonnss resources are applied.  If no function flags
               are specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS property, functions indi-
               cated by the MWM cclliieennttFFuunnccttiioonnss and ttrraannssiieennttFFuunnccttiioonnss
               resources are applied.  The default for the XXmmNNmmwwmmFFuunnccttiioonnss
               resource is not to specify any function flags for the
               __MMOOTTIIFF__WWMM__HHIINNTTSS property.

     XXmmNNmmwwmmIInnppuuttMMooddee
               Specifies the input mode flag (application modal or system
               modal input constraints) for the __MMOOTTIIFF__WWMM__HHIINNTTSS property.  If
               no input mode flag is specified by the __MMOOTTIIFF__WWMM__HHIINNTTSS pro-
               perty, no input constraints are applied, and input goes to any


   2-96






                                                              VendorShell(3X)


               window.  The default for the XXmmNNmmwwmmIInnppuuttMMooddee resource is not
               to specify any input mode flag for the __MMOOTTIIFF__WWMM__HHIINNTTSS pro-
               perty.  An application that sets input constraints on a dialog
               usually uses the BulletinBoard's XXmmNNddiiaallooggSSttyyllee resource
               rather than the parent DialogShell's XXmmNNmmwwmmIInnppuuttMMooddee resource.

     XXmmNNmmwwmmMMeennuu
               Specifies the menu items that the Motif window manager should
               add to the end of the window menu.  The string contains a list
               of items separated by \n with the following format:
               _l_a_b_e_l [_m_n_e_m_o_n_i_c] [_a_c_c_e_l_e_r_a_t_o_r] _f_u_n_c_t_i_o_n
               If more than one item is specified, the items should be
               separated by a newline character.

     XXmmNNtteexxttFFoonnttLLiisstt
               Specifies the font list used for VendorShell's Text and List
               descendants.  If this value is NULL at initialization and if
               the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNtteexxttFFoonnttLLiisstt
               is initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the
               value of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNtteexxttFFoonnttLLiisstt is ini-
               tialized by looking up the parent hierarchy of the widget for
               an ancestor that is a subclass of the XmBulletinBoard or Ven-
               dorShell widget class.  If such an ancestor is found,
               XXmmNNtteexxttFFoonnttLLiisstt is initialized to the XXmmNNtteexxttFFoonnttLLiisstt of the
               ancestor widget.  If no such ancestor is found, the default is
               implementation dependent.

     Inherited Resources

     VendorShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   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


   2-97






   VendorShell(3X)


   XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
   XmNtransient       XmCTransient       Boolean   False                   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
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), mmwwmm((11XX)), SShheellll((33XX)), WWMMSShheellll((33XX)),
     XXmmAAccttiivvaatteePPrroottooccooll((33XX)), XXmmAAccttiivvaatteeWWMMPPrroottooccooll((33XX)),
     XXmmAAddddPPrroottooccoollCCaallllbbaacckk((33XX)), XXmmAAddddWWMMPPrroottooccoollCCaallllbbaacckk((33XX)),
     XXmmAAddddPPrroottooccoollss((33XX)), XXmmAAddddWWMMPPrroottooccoollss((33XX)), XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)),
     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX)), XXmmGGeettAAttoommNNaammee((33XX)), XXmmIInntteerrnnAAttoomm((33XX)),
     XXmmIIssMMoottiiffWWMMRRuunnnniinngg((33XX)), XXmmRReemmoovveePPrroottooccoollCCaallllbbaacckk((33XX)),


   2-98






                                                              VendorShell(3X)


     XXmmRReemmoovveeWWMMPPrroottooccoollCCaallllbbaacckk((33XX)), XXmmRReemmoovveePPrroottooccoollss((33XX)),
     XXmmRReemmoovveeWWMMPPrroottooccoollss((33XX)), XXmmSSeettPPrroottooccoollHHooookkss((33XX)), and
     XXmmSSeettWWMMPPrroottooccoollHHooookkss((33XX)).





















































   2-99






   WMShell(3X)



   NAME
     WWMMSShheellll-The WMShell widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//XXmm..hh>>
     ##iinncclluuddee <<XX1111//SShheellll..hh>>

   DESCRIPTION
     WMShell is a top-level widget that encapsulates the interaction with the
     window manager.

     Classes

     WMShell inherits behavior and resources from CCoorree, CCoommppoossiittee, and SShheellll
     classes.

     The class pointer is wwmmSShheellllWWiiddggeettCCllaassss.

     The class name is WWMMSShheellll.

     New Resources

     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 XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     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 XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                WWMMSShheellll RReessoouurrccee SSeett
   NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
   ______________________________________________________________________________
   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   False                   CSG
   XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
   XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
   XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
   XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG


   2-100






                                                                  WMShell(3X)


   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   False                   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

     XXmmNNbbaasseeHHeeiigghhtt
               Specifies the base for a progression of preferred heights for
               the window manager to use in sizing the widget.  The preferred
               heights are XXmmNNbbaasseeHHeeiigghhtt plus integral multiples of
               XXmmNNhheeiigghhttIInncc, with a minimum of XXmmNNmmiinnHHeeiigghhtt and a maximum of
               XXmmNNmmaaxxHHeeiigghhtt.  If an initial value is not supplied for
               XXmmNNbbaasseeHHeeiigghhtt but is supplied for XXmmNNbbaasseeWWiiddtthh, the value of
               XXmmNNbbaasseeHHeeiigghhtt is set to 0 when the widget is realized.

     XXmmNNbbaasseeWWiiddtthh
               Specifies the base for a progression of preferred widths for
               the window manager to use in sizing the widget.  The preferred
               widths are XXmmNNbbaasseeWWiiddtthh plus integral multiples of
               XXmmNNwwiiddtthhIInncc, with a minimum of XXmmNNmmiinnWWiiddtthh and a maximum of
               XXmmNNmmaaxxWWiiddtthh.  If an initial value is not supplied for
               XXmmNNbbaasseeWWiiddtthh but is supplied for XXmmNNbbaasseeHHeeiigghhtt, the value of
               XXmmNNbbaasseeWWiiddtthh is set to 0 when the widget is realized.

     XXmmNNhheeiigghhttIInncc
               Specifies the increment for a progression of preferred heights
               for the window manager to use in sizing the widget.  The pre-
               ferred heights are XXmmNNbbaasseeHHeeiigghhtt plus integral multiples of
               XXmmNNhheeiigghhttIInncc, with a minimum of XXmmNNmmiinnHHeeiigghhtt and a maximum of
               XXmmNNmmaaxxHHeeiigghhtt.  If an initial value is not supplied for
               XXmmNNhheeiigghhttIInncc but is supplied for XXmmNNwwiiddtthhIInncc, the value of
               XXmmNNhheeiigghhttIInncc is set to 1 when the widget is realized.

     XXmmNNiiccoonnMMaasskk
               Specifies a bitmap that could be used by the window manager to
               clip the XXmmNNiiccoonnPPiixxmmaapp bitmap to make the icon nonrectangular.

     XXmmNNiiccoonnPPiixxmmaapp
               Specifies a bitmap that could be used by the window manager as
               the application's icon.

     XXmmNNiiccoonnWWiinnddooww
               Specifies the ID of a window that could be used by the window
               manager as the application's icon.

     XXmmNNiiccoonnXX  Specifies a suitable place to put the application's icon; this
               is a hint to the window manager in root window coordinates.


   2-101






   WMShell(3X)


               Since the window manager controls icon placement policy, this
               may be ignored.  If no initial value is specified, the value
               is set to -1 when the widget is realized.

     XXmmNNiiccoonnYY  Specifies a suitable place to put the application's icon; this
               is a hint to the window manager in root window coordinates.
               Since the window manager controls icon placement policy, this
               may be ignored.  If no initial value is specified, the value
               is set to -1 when the widget is realized.

     XXmmNNiinniittiiaallSSttaattee
               Specifies the state in which the application wishes the widget
               instance to start.  It must be one of the constants NNoorrmmaall--
               SSttaattee or IIccoonniiccSSttaattee.

     XXmmNNiinnppuutt  Specifies the application's input model for this widget and
               its descendants.  The meaning of a True or False value for
               this resource depends on the presence or absence of a
               WWMM__TTAAKKEE__FFOOCCUUSS atom in the WWMM__PPRROOTTOOCCOOLLSS property:
                         IInnppuutt MMooddeell       XXmmNNiinnppuutt   WWMM__TTAAKKEE__FFOOCCUUSS
                         __________________________________________
                         No input          False      Absent
                         Passive           True       Absent
                         Locally active    True       Present
                         Globally active   False      Present
               For more information on input models, see the X Consortium
               Standard _I_n_t_e_r-_C_l_i_e_n_t _C_o_m_m_u_n_i_c_a_t_i_o_n _C_o_n_v_e_n_t_i_o_n_s _M_a_n_u_a_l.

     XXmmNNmmaaxxAAssppeeccttXX
               Specifies the numerator of the maximum aspect ratio (X/Y) that
               the application wishes the widget instance to have.

     XXmmNNmmaaxxAAssppeeccttYY
               Specifies the denominator of the maximum aspect ratio (X/Y)
               that the application wishes the widget instance to have.

     XXmmNNmmaaxxHHeeiigghhtt
               Specifies the maximum height that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmaaxxHHeeiigghhtt but is supplied for XXmmNNmmaaxxWWiiddtthh, the value of
               XXmmNNmmaaxxHHeeiigghhtt is set to 32767 when the widget is realized.

     XXmmNNmmaaxxWWiiddtthh
               Specifies the maximum width that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmaaxxWWiiddtthh but is supplied for XXmmNNmmaaxxHHeeiigghhtt, the value of
               XXmmNNmmaaxxWWiiddtthh is set to 32767 when the widget is realized.

     XXmmNNmmiinnAAssppeeccttXX
               Specifies the numerator of the minimum aspect ratio (X/Y) that
               the application wishes the widget instance to have.

     XXmmNNmmiinnAAssppeeccttYY
               Specifies the denominator of the minimum aspect ratio (X/Y)


   2-102






                                                                  WMShell(3X)


               that the application wishes the widget instance to have.

     XXmmNNmmiinnHHeeiigghhtt
               Specifies the minimum height that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmiinnHHeeiigghhtt but is supplied for XXmmNNmmiinnWWiiddtthh, the value of
               XXmmNNmmiinnHHeeiigghhtt is set to 1 when the widget is realized.

     XXmmNNmmiinnWWiiddtthh
               Specifies the minimum width that the application wishes the
               widget instance to have.  If an initial value is not supplied
               for XXmmNNmmiinnWWiiddtthh but is supplied for XXmmNNmmiinnHHeeiigghhtt, the value of
               XXmmNNmmiinnWWiiddtthh is set to 1 when the widget is realized.

     XXmmNNttiittllee  Specifies the application name to be displayed by the window
               manager.  The default is the icon name if specified, otherwise
               the name of the application.

     XXmmNNttiittlleeEEnnccooddiinngg
               Specifies a property type that represents the encoding of the
               XXmmNNttiittllee string.  If a language procedure has been set, the
               default is None; otherwise, the default is XA_STRING.  When
               the widget is realized, if the value is None, the correspond-
               ing name is assumed to be in the current locale.  The name is
               passed to XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an encoding style of
               XXSSttddIICCCCTTeexxttSSttyyllee.  The resulting encoding is "STRING" if the
               name is fully convertible to "STRING," otherwise
               "COMPOUND_TEXT."  The values of the encoding resources are not
               changed; they remain None.

     XXmmNNttrraannssiieenntt
               Specifies a Boolean value that is True if the widget instance
               is transient, typically a popup on behalf of another widget.
               The window manager may treat a transient widget's window dif-
               ferently from other windows.  For example, a window manager
               may not iconify a transient window separately from its associ-
               ated application.  Applications and users should not normally
               alter this resource.

     XXmmNNwwaaiittFFoorrWWmm
               When True, specifies that the Intrinsics waits the length of
               time given by the XXmmNNwwmmTTiimmeeoouutt resource for the window manager
               to respond to certain actions before assuming that there is no
               window manager present.  This resource is altered by the
               Intrinsics as it receives, or fails to receive, responses from
               the window manager.

     XXmmNNwwiiddtthhIInncc
               Specifies the base for a progression of preferred widths for
               the window manager to use in sizing the widget.  The preferred
               widths are XXmmNNbbaasseeWWiiddtthh plus integral multiples of
               XXmmNNwwiiddtthhIInncc, with a minimum of XXmmNNmmiinnWWiiddtthh and a maximum of
               XXmmNNmmaaxxWWiiddtthh.  If an initial value is not supplied for
               XXmmNNwwiiddtthhIInncc but is supplied for XXmmNNhheeiigghhttIInncc, the value of


   2-103






   WMShell(3X)


               XXmmNNwwiiddtthhIInncc is set to 1 when the widget is realized.

     XXmmNNwwiinnddoowwGGrroouupp
               Specifies the ID of a window with which this widget instance
               is associated.  By convention, this window is the "leader" of
               a group of windows.  A window manager may treat all windows in
               a group in some way; for example, it may always move or icon-
               ify them together.
               If no initial value is specified, the value is set to the win-
               dow of the first realized ancestor widget in the parent
               hierarchy when the widget is realized.  If a value of XXttUUnn--
               ssppeecciiffiieeddWWiinnddoowwGGrroouupp is specified, no window group is set.

     XXmmNNwwiinnGGrraavviittyy
               Specifies the window gravity for use by the window manager in
               positioning the widget.  If no initial value is specified, the
               value is set when the widget is realized.  If XXmmNNggeeoommeettrryy is
               not NULL, XXmmNNwwiinnGGrraavviittyy is set to the window gravity returned
               by XXWWMMGGeeoommeettrryy.  Otherwise, XXmmNNwwiinnGGrraavviittyy is set to NNoorrtthhWWeesstt--
               GGrraavviittyy.

     XXmmNNwwmmTTiimmeeoouutt
               Specifies the length of time that the Intrinsics waits for the
               window manager to respond to certain actions before assuming
               that there is no window manager present.  The value is in mil-
               liseconds and must not be negative.

     Inherited Resources

     WMShell inherits behavior and resources from the following superclasses.
     For a complete description of each resource, refer to the man page for
     that superclass.
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   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                  False            CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G


   2-104






                                                                  WMShell(3X)


   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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), and SShheellll((33XX)).




































   2-105



 d
