


     OObbjjeecctt((33XX))               RReeffeerreennccee PPaaggeess               OObbjjeecctt((33XX))



     NNAAMMEE
          OObbjjeecctt-The Object widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//XXmm..hh>>


     DDEESSCCRRIIPPTTIIOONN
          Object is never instantiated.  Its sole purpose is as a
          supporting superclass for other widget classes.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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-84                                             (printed 5/7/92)






     OOvveerrrriiddeeSShheellll((33XX))        RReeffeerreennccee PPaaggeess        OOvveerrrriiddeeSShheellll((33XX))



     NNAAMMEE
          OOvveerrrriiddeeSShheellll-The OverrideShell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          OverrideShell is used for shell windows that completely
          bypass the window manager, for example, PopupMenu shells.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          OverrideShell defines no new resources, but overrides the
          XXmmNNoovveerrrriid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.

        IInnhheerriitteedd RReessoouurrcceess
          OverrideShell inherits behavior and resources from the
          following superclasses.  For a complete description of each
          resource, refer to the man page for that superclass.

          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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







     2-85                                             (printed 5/7/92)






     OOvveerrrriiddeeSShheellll((33XX))        RReeffeerreennccee PPaaggeess        OOvveerrrriiddeeSShheellll((33XX))



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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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-86                                             (printed 5/7/92)






     RReeccttOObbjj((33XX))              RReeffeerreennccee PPaaggeess              RReeccttOObbjj((33XX))



     NNAAMMEE
          RReeccttOObbjj-The RectObj widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//XXmm..hh>>


     DDEESSCCRRIIPPTTIIOONN
          RectObj is never instantiated.  Its sole purpose is as a
          supporting superclass for other widget classes.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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-87                                             (printed 5/7/92)






     RReeccttOObbjj((33XX))              RReeffeerreennccee PPaaggeess              RReeccttOObbjj((33XX))



          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ns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 RectObj 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 argument.  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.
















     2-88                                             (printed 5/7/92)






     RReeccttOObbjj((33XX))              RReeffeerreennccee PPaaggeess              RReeccttOObbjj((33XX))



        IInnhheerriitteedd RReessoouurrcceess
          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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          OObbjjeecctt((33XX)).












































     2-89                                             (printed 5/7/92)






     SShheellll((33XX))                RReeffeerreennccee PPaaggeess                SShheellll((33XX))



     NNAAMMEE
          SShheellll-The Shell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          Shell is a top-level widget (with only one managed child)
          that encapsulates 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.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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







     2-90                                             (printed 5/7/92)






     SShheellll((33XX))                RReeffeerreennccee PPaaggeess                SShheellll((33XX))



     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
                    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 unrealized 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.  Applications 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



     2-91                                             (printed 5/7/92)






     SShheellll((33XX))                RReeffeerreennccee PPaaggeess                SShheellll((33XX))



                    is unmapped.  This is a hint, and an
                    implementation may save contents whenever it
                    desires, including always or never.

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


        IInnhheerriitteedd RReessoouurrcceess
          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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)) and CCoorree((33XX)).











     2-92                                             (printed 5/7/92)






     TTooppLLeevveellSShheellll((33XX))        RReeffeerreennccee PPaaggeess        TTooppLLeevveellSShheellll((33XX))



     NNAAMMEE
          TTooppLLeevveellSShheellll-The TopLevelShell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          TopLevelShell is used for normal top-level windows such as
          any additional top-level widgets an application needs.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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.




     2-93                                             (printed 5/7/92)






     TTooppLLeevveellSShheellll((33XX))        RReeffeerreennccee PPaaggeess        TTooppLLeevveellSShheellll((33XX))



          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 iconified.

          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
                    corresponding 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.


        IInnhheerriitteedd RReessoouurrcceess
          TopLevelShell inherits behavior and resources from the
          following superclasses.  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







     2-94                                             (printed 5/7/92)






     TTooppLLeevveellSShheellll((33XX))        RReeffeerreennccee PPaaggeess        TTooppLLeevveellSShheellll((33XX))



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







     2-95                                             (printed 5/7/92)






     TTooppLLeevveellSShheellll((33XX))        RReeffeerreennccee PPaaggeess        TTooppLLeevveellSShheellll((33XX))



     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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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-96                                             (printed 5/7/92)






     TTrraannssiieennttSShheellll((33XX))       RReeffeerreennccee PPaaggeess       TTrraannssiieennttSShheellll((33XX))



     NNAAMMEE
          TTrraannssiieennttSShheellll-The TransientShell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          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 application.  They are
          iconified by the window manager only if the main application
          shell is iconified.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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 overrides 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







     2-97                                             (printed 5/7/92)






     TTrraannssiieennttSShheellll((33XX))       RReeffeerreennccee PPaaggeess       TTrraannssiieennttSShheellll((33XX))



         _____________________________________________________________
         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 realized, the XXmmNNwwiinnddoowwGGrroouupp is
                    used instead.


        IInnhheerriitteedd RReessoouurrcceess
          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
          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).

                                   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







     2-98                                             (printed 5/7/92)






     TTrraannssiieennttSShheellll((33XX))       RReeffeerreennccee PPaaggeess       TTrraannssiieennttSShheellll((33XX))



     XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
     XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
     XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
     XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
     XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
     XmNiconX           XmCIconX           int       -1                      CSG
     XmNiconY           XmCIconY           int       -1                      CSG
     XmNinitialState    XmCInitialState    int       NormalState             CSG
     XmNinput           XmCInput           Boolean   True                    CSG
     XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
     XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
     XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
     XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
     XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
     XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
     XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG
     XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
     XmNtitle           XmCTitle           String    dynamic                 CSG
     XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
     XmNtransient       XmCTransient       Boolean   True                    CSG
     XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
     XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
     XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
     XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
     XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG

                                              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
     ______________________________________________________________________________________________________________







     2-99                                             (printed 5/7/92)






     TTrraannssiieennttSShheellll((33XX))       RReeffeerreennccee PPaaggeess       TTrraannssiieennttSShheellll((33XX))



     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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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-100                                            (printed 5/7/92)






     UUiill((33XX))                  RReeffeerreennccee PPaaggeess                  UUiill((33XX))



     NNAAMMEE
          UUiill-Invokes the UIL compiler from within an application

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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;;


     DDEESSCCRRIIPPTTIIOONN
          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 argument 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 function is invoked.




     2-101                                            (printed 5/7/92)






     UUiill((33XX))                  RReeffeerreennccee PPaaggeess                  UUiill((33XX))



          _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 argument 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;
              /* 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-102                                            (printed 5/7/92)






     UUiill((33XX))                  RReeffeerreennccee PPaaggeess                  UUiill((33XX))



          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 interpret 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 severities, 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.




     2-103                                            (printed 5/7/92)






     UUiill((33XX))                  RReeffeerreennccee PPaaggeess                  UUiill((33XX))



          _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.

          _m_e_s_s_a_g_e__c_o_u_n_t       An array of integers containing the
                              number of diagnostic 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 argument 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.









     2-104                                            (printed 5/7/92)






     UUiill((33XX))                  RReeffeerreennccee PPaaggeess                  UUiill((33XX))



          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 interpret 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 diagnostic 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 function.
                              See the "RETURN VALUE" section below.


     RREETTUURRNN VVAALLUUEE
          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.

          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-105                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



     NNAAMMEE
          VVeennddoorrSShheellll-The VendorShell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     HHIISSTTOORRYY//DDIIRREECCTTIIOONN
          The description of the geometry management of shells and
          their children has been changed (for Trial-use).  New
          resources have been added specifying font lists for button,
          label, and text children (for Trial-use).

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          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
          coordinates of the child's upper left outside corner
          relative to the parent's upper left inside corner are both
          zero minus the value of XXmmNNbboorrd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.




     2-106                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



        CCllaasssseess
          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.

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

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a 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 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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 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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nFFoonnttLLiisstt of the
                    ancestor  widget.  If no such ancestor is found,



     2-107                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



                    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 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ICCIITT, specifying a click-to-type policy, and
                    XXmmPPOOIINNTTEERR, specifying 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 descendants (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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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



     2-108                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



                    cclliieennttDDeeccoorraattiioonn and ttrraanns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,
                    decorations 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ns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 functions 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ns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 indicated 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 property, no
                    input constraints are applied, and input goes to
                    any 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 property.

                    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



     2-109                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



                    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 initialized by looking up the
                    parent hierarchy of the widget for an ancestor
                    that is a subclass of the XmBulletinBoard or
                    VendorShell 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.


        IInnhheerriitteedd RReessoouurrcceess
          VendorShell inherits behavior and resources from the
          following superclasses.  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
     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







     2-110                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



     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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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-111                                            (printed 5/7/92)






     VVeennddoorrSShheellll((33XX))          RReeffeerreennccee PPaaggeess          VVeennddoorrSShheellll((33XX))



          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-112                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



     NNAAMMEE
          WWMMSShheellll-The WMShell widget class

     AAEESS SSUUPPPPOORRTT LLEEVVEELL
          Full-use

     SSYYNNOOPPSSIISS
          ##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>>


     DDEESSCCRRIIPPTTIIOONN
          WMShell is a top-level widget that encapsulates the
          interaction with the window manager.

        CCllaasssseess
          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.

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the 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







     2-113                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



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



     2-114                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



                    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.  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lS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.



     2-115                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



          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) 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.




     2-116                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



          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
                    corresponding 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 differently from
                    other windows.  For example, a window manager may
                    not iconify a transient window separately from its
                    associated 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 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



     2-117                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



                    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
                    iconify them together.

                    If no initial value is specified, the value is set
                    to the window of the first realized ancestor
                    widget in the parent hierarchy when the widget is
                    realized.  If a value of XXttUUnns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tG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 milliseconds and
                    must not be negative.


        IInnhheerriitteedd RReessoouurrcceess
          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







     2-118                                            (printed 5/7/92)






     WWMMSShheellll((33XX))              RReeffeerreennccee PPaaggeess              WWMMSShheellll((33XX))



     ______________________________________________________________________
     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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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-119                                            (printed 5/7/92)



 m
