


     XXmmMMaaiinnWWiinnddooww((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMaaiinnWWiinnddooww((33XX))



     NNAAMMEE
          XXmmMMaaiinnWWiinnddooww-The MainWindow 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//MMaaiinnWW..hh>>


     DDEESSCCRRIIPPTTIIOONN
          MainWindow provides a standard layout for the primary window
          of an application.  This layout includes a MenuBar, a
          CommandWindow, a work region, a MessageWindow, and
          ScrollBars.  Any or all of these areas are optional.  The
          work region and ScrollBars in the MainWindow behave
          identically to the work region and ScrollBars in the
          ScrolledWindow widget.  The user can think of the MainWindow
          as an extended ScrolledWindow with an optional MenuBar and
          optional CommandWindow and MessageWindow.

          In a fully-loaded MainWindow, the MenuBar spans the top of
          the window horizontally.  The CommandWindow spans the
          MainWindow horizontally just below the MenuBar, and the work
          region lies below the CommandWindow.  The MessageWindow is
          is below the work region.  Any space remaining below the
          MessageWindow is managed in a manner identical to
          ScrolledWindow.  The behavior of ScrolledWindow can be
          controlled by the ScrolledWindow resources.  To create a
          MainWindow, first create the work region elements, a
          MenuBar, a CommandWindow, a MessageWindow, a horizontal
          ScrollBar, and a vertical ScrollBar widget, and then call
          XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass with those widget IDs.

          MainWindow can also create three Separator widgets that
          provide a visual separation of MainWindow's four components.

        CCllaasssseess
          MainWindow inherits behavior and resources from CCoorree,
          CCoommppoossiittee, CCoonnssttrraaiinntt, XXmmMMaannaaggeerr, and SSccrroolllleeddWWiinnddooww
          classes.

          The class pointer is xxmmMMaaiinnWWiinnddoowwWWiiddggeettCCllaassss.

          The class name is XXmmMMaaiinnWWiinnddooww.

        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



     2-424                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddooww((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMaaiinnWWiinnddooww((33XX))



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

                                         XXmmMMaaiinnWWiinnddooww 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
     _________________________________________________________________________________________________
     XmNcommandWindow            XmCCommandWindow            Widget          NULL               CSG
     XmNcommandWindowLocation    XmCCommandWindowLocation    unsigned char   ABOVE (SeeDesc.)   CG
     XmNmainWindowMarginHeight   XmCMainWindowMarginHeight   Dimension       0                  CSG
     XmNmainWindowMarginWidth    XmCMainWindowMarginWidth    Dimension       0                  CSG
     XmNmenuBar                  XmCMenuBar                  Widget          NULL               CSG
     XmNmessageWindow            XmCMessageWindow            Widget          NULL               CSG
     XmNshowSeparator            XmCShowSeparator            Boolean         False              CSG


          XXmmNNccoommmmaannddWWiinnddooww
                    Specifies the widget to be laid out as the
                    CommandWindow.  This widget must have been
                    previously created and managed as a child of
                    MainWindow.

          XXmmNNccoommmmaannddWWiinnddoowwLLooccaattiioonn
                    Controls the position of the command window.
                    XXmmCCOOMMMMAANNDD__AABBOOVVEE__WWOORRKKSSPPAACCEE locates the command
                    window between the menu bar and the work window.
                    XXmmCCOOMMMMAANNDD__BBEELLOOWW__WWOORRKKSSPPAACCEE locates the command
                    window between the work window and the message
                    window.

          XXmmNNmmaaiinnWWiinnddoowwMMaarrggiinnHHeeiigghhtt
                    Specifies the margin height on the top and bottom
                    of MainWindow.  This resource overrides any
                    setting of the ScrolledWindow resource
                    XXmmNNssccrroolllleeddWWiinnddoowwMMaarrggiinnHHeeiigghhtt.

          XXmmNNmmaaiinnWWiinnddoowwMMaarrggiinnWWiiddtthh
                    Specifies the margin width on the right and left
                    sides of MainWindow.  This resource overrides any
                    setting of the ScrolledWindow resource
                    XXmmNNssccrroolllleeddWWiinnddoowwMMaarrggiinnWWiiddtthh.

          XXmmNNmmeennuuBBaarr
                    Specifies the widget to be laid out as the
                    MenuBar.  This widget must have been previously
                    created and managed as a child of MainWindow.




     2-425                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddooww((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMaaiinnWWiinnddooww((33XX))



          XXmmNNmmeessssaaggeeWWiinnddooww
                    Specifies the widget to be laid out as the
                    MessageWindow.  This widget must have been
                    previously created and managed as a child of
                    MainWindow.  The MessageWindow is positioned at
                    the bottom of the MainWindow.  If this value is
                    NULL, no message window is included in the
                    MainWindow.

          XXmmNNsshhoowwSSeeppaarraattoorr
                    Displays separators between the components of the
                    MainWindow when set to True.  If set to False, no
                    separators are displayed.


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

                                             XXmmSSccrroolllleeddWWiinnddooww 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
     ______________________________________________________________________________________________________________
     XmNclipWindow                   XmCClipWindow                   Widget          dynamic                 G
     XmNhorizontalScrollBar          XmCHorizontalScrollBar          Widget          dynamic                 CSG
     XmNscrollBarDisplayPolicy       XmCScrollBarDisplayPolicy       unsigned char   dynamic                 CSG
     XmNscrollBarPlacement           XmCScrollBarPlacement           unsigned char   XmBOTTOM_RIGHT          CSG
     XmNscrolledWindowMarginHeight   XmCScrolledWindowMarginHeight   Dimension       0                       N/A
     XmNscrolledWindowMarginWidth    XmCScrolledWindowMarginWidth    Dimension       0                       N/A
     XmNscrollingPolicy              XmCScrollingPolicy              unsigned char   XmAPPLICATION_DEFINED   CG
     XmNspacing                      XmCSpacing                      Dimension       4                       CSG
     XmNverticalScrollBar            XmCVerticalScrollBar            Widget          dynamic                 CSG
     XmNvisualPolicy                 XmCVisualPolicy                 unsigned char   dynamic                 G
     XmNworkWindow                   XmCWorkWindow                   Widget          NULL                    CSG

                                          XXmmMMaannaaggeerr 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
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG
     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG







     2-426                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddooww((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMaaiinnWWiinnddooww((33XX))



     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
     XmNuserData             XmCUserData             XtPointer           NULL                   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        0                      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onnssttrraaiinntt((33XX)), CCoorree((33XX)),
          XXmmCCrreeaatteeMMaaiinnWWiinnddooww((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp11((33XX)),
          XXmmMMaaiinnWWiinnddoowwSSeepp22((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp33((33XX)),
          XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX)), XXmmMMaannaaggeerr((33XX)), and
          XXmmSSccrroolllleeddWWiinnddooww((33XX))















     2-427                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddoowwSSeepp11((33XX))     RReeffeerreennccee PPaaggeess     XXmmMMaaiinnWWiinnddoowwSSeepp11((33XX))



     NNAAMMEE
          XXmmMMaaiinnWWiinnddoowwSSeepp11-A MainWindow function that returns the
          widget ID of the first Separator widget

     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 XXmmMMaaiinnWWiinnddoowwSSeepp11 function is scheduled for removal in
          revision E.

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

          WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp11 ((_w_i_d_g_e_t))
               WWiiddggeett    _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMaaiinnWWiinnddoowwSSeepp11 returns the widget ID of the first
          Separator widget in the MainWindow.  The first Separator
          widget is located between the MenuBar and the Command
          widget.  This Separator is visible only when
          XXmmNNsshhoowwSSeeppaarraattoorr is True.


          _w_i_d_g_e_t Specifies the MainWindow widget ID


          For a complete definition of MainWindow and its associated
          resources, see XXmmMMaaiinnWWiinnddooww((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID of the first Separator.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMaaiinnWWiinnddooww((33XX)).


















     2-428                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddoowwSSeepp22((33XX))     RReeffeerreennccee PPaaggeess     XXmmMMaaiinnWWiinnddoowwSSeepp22((33XX))



     NNAAMMEE
          XXmmMMaaiinnWWiinnddoowwSSeepp22-A MainWindow function that returns the
          widget ID of the second Separator widget

     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 XXmmMMaaiinnWWiinnddoowwSSeepp22 function is scheduled for removal in
          revision E.

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

          WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp22 ((_w_i_d_g_e_t))
               WWiiddggeett           _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMaaiinnWWiinnddoowwSSeepp22 returns the widget ID of the second
          Separator widget in the MainWindow.  The second Separator
          widget is located between the Command widget and the
          ScrolledWindow.  This Separator is visible only when
          XXmmNNsshhoowwSSeeppaarraattoorr is True.

          _w_i_d_g_e_t Specifies the MainWindow widget ID


          For a complete definition of MainWindow and its associated
          resources, see XXmmMMaaiinnWWiinnddooww((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID of the second Separator.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMaaiinnWWiinnddooww((33XX)).



















     2-429                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddoowwSSeepp33((33XX))     RReeffeerreennccee PPaaggeess     XXmmMMaaiinnWWiinnddoowwSSeepp33((33XX))



     NNAAMMEE
          XXmmMMaaiinnWWiinnddoowwSSeepp33-A MainWindow function that returns the
          widget ID of the third Separator widget

     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 XXmmMMaaiinnWWiinnddoowwSSeepp33 function is scheduled for removal in
          revision E.

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

          WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp33 ((_w_i_d_g_e_t))
               WWiiddggeett           _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMaaiinnWWiinnddoowwSSeepp33 returns the widget ID of the third
          Separator widget in the MainWindow.  The third Separator
          widget is located between the message window and the widget
          above it.  This Separator is visible only when
          XXmmNNsshhoowwSSeeppaarraattoorr is True.


          _w_i_d_g_e_t Specifies the MainWindow widget ID


          For a complete definition of MainWindow and its associated
          resources, see XXmmMMaaiinnWWiinnddooww((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID of the third Separator.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMaaiinnWWiinnddooww((33XX)).


















     2-430                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX)) RReeffeerreennccee PPaaggeess XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX))



     NNAAMMEE
          XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass-A MainWindow function that identifies
          manageable children for each area

     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//MMaaiinnWW..hh>>

          vvooiidd XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass ((_w_i_d_g_e_t, _m_e_n_u__b_a_r, _c_o_m_m_a_n_d__w_i_n_d_o_w,
                    _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r, _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r, _w_o_r_k__r_e_g_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               WWiiddggeett    _m_e_n_u__b_a_r;;
               WWiiddggeett    _c_o_m_m_a_n_d__w_i_n_d_o_w;;
               WWiiddggeett    _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r;;
               WWiiddggeett    _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r;;
               WWiiddggeett    _w_o_r_k__r_e_g_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass identifies which of the valid children
          for each area (such as the MenuBar and work region) are to
          be actively managed by MainWindow.  This function also sets
          up or adds the MenuBar, work window, command window, and
          ScrollBar widgets to the application's main window widget.

          Each area is optional; therefore, the user can pass NULL to
          one or more of the following arguments.  The window manager
          provides the title bar.


          _w_i_d_g_e_t      Specifies the MainWindow widget ID.

          _m_e_n_u__b_a_r    Specifies the widget ID for the MenuBar to be
                      associated with the MainWindow widget.  Set this
                      ID only after creating an instance of the
                      MainWindow widget.  The attribute name
                      associated with this argument is XXmmNNmmeennuuBBaarr.

          _c_o_m_m_a_n_d__w_i_n_d_o_w
                      Specifies the widget ID for the command window
                      to be associated with the MainWindow widget.
                      Set this ID only after creating an instance of
                      the MainWindow widget.  The attribute name
                      associated with this argument is
                      XXmmNNccoommmmaannddWWiinnddooww.

          _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r
                      Specifies the ScrollBar widget ID for the
                      horizontal ScrollBar to be associated with the
                      MainWindow widget.  Set this ID only after



     2-431                                            (printed 5/7/92)






     XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX)) RReeffeerreennccee PPaaggeess XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX))



                      creating an instance of the MainWindow widget.
                      The attribute name associated with this argument
                      is XXmmNNhhoorriizzoonnttaallSSccrroollllBBaarr.

          _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r
                      Specifies the ScrollBar widget ID for the
                      vertical ScrollBar to be associated with the
                      MainWindow widget.  Set this ID only after
                      creating an instance of the MainWindow widget.
                      The attribute name associated with this argument
                      is XXmmNNvveerrttiiccaallSSccrroollllBBaarr.

          _w_o_r_k__r_e_g_i_o_n Specifies the widget ID for the work window to
                      be associated with the MainWindow widget.  Set
                      this ID only after creating an instance of the
                      MainWindow widget.  The attribute name
                      associated with this argument is XXmmNNwwoorrkkWWiinnddooww.


          For a complete definition of MainWindow and its associated
          resources, see XXmmMMaaiinnWWiinnddooww((33XX)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMaaiinnWWiinnddooww((33XX)).































     2-432                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



     NNAAMMEE
          XXmmMMaannaaggeerr-The Manager 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
          Manager is a widget class used as a supporting superclass
          for other widget classes.  It supports the visual resources,
          graphics contexts, and traversal resources necessary for the
          graphics and traversal mechanisms.

        CCllaasssseess
          Manager inherits behavior and resources from CCoorree,
          CCoommppoossiittee, and CCoonnssttrraaiinntt classes.

          The class pointer is xxmmMMaannaaggeerrWWiiddggeettCCllaassss.

          The class name is XXmmMMaannaaggeerr.

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

                                          XXmmMMaannaaggeerr 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
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG







     2-433                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG
     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
     XmNuserData             XmCUserData             XtPointer           NULL                   CSG


          XXmmNNbboottttoommSShhaaddoowwCCoolloorr
                    Specifies the color to use to draw the bottom and
                    right sides of the border shadow.  This color is
                    used if the XXmmNNbboottttoommSShhaaddoowwPPiixxmmaapp resource is
                    NULL.

          XXmmNNbboottttoommSShhaaddoowwPPiixxmmaapp
                    Specifies the pixmap to use to draw the bottom and
                    right sides of the border shadow.

          XXmmNNffoorreeggrroouunndd
                    Specifies the foreground drawing color used by
                    manager widgets.

          XXmmNNhheellppCCaallllbbaacckk
                    Specifies the list of callbacks that are called
                    when the help key sequence is pressed.  The reason
                    sent by this callback is XXmmCCRR__HHEELLPP.

          XXmmNNhhiigghhlliigghhttCCoolloorr
                    Specifies the color of the highlighting rectangle.
                    This color is used if the highlight pixmap
                    resource is XXmmUUNNSSPPEECCIIFFIIEEDD__PPIIXXMMAAPP.

          XXmmNNhhiigghhlliigghhttPPiixxmmaapp
                    Specifies the pixmap used to draw the highlighting
                    rectangle.

          XXmmNNnnaavviiggaattiioonnTTyyppee
                    Determines whether the widget is a tab group.


                      +o  XXmmNNOONNEE indicates that the widget is not a tab
                         group.

                      +o  XXmmTTAABB__GGRROOUUPP indicates that the widget is a
                         tab group, unless another widget in the
                         hierarchy has an XXmmNNnnaavviiggaattiioonnTTyyppee of
                         XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP.

                      +o  XXmmSSTTIICCKKYY__TTAABB__GGRROOUUPP indicates that the widget
                         is a tab group, even if another widget in the
                         hierarchy has an XXmmNNnnaavviiggaattiioonnTTyyppee of



     2-434                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



                         XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP.

                      +o  XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP indicates that the
                         widget is a tab group and that widgets in the
                         hierarchy whose XXmmNNnnaavviiggaattiioonnTTyyppee is
                         XXmmTTAABB__GGRROOUUPP are not tab groups.

                         When a parent widget has an XXmmNNnnaavviiggaattiioonnTTyyppee
                         of XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP, traversal of non-
                         tab-group widgets within the group is based
                         on the order of those widgets in their
                         parent's XXmmNNcchhiillddrreenn list.


          XXmmNNsshhaaddoowwTThhiicckknneessss
                    Specifies the thickness of the drawn border
                    shadow.  XXmmBBuulllleettiinnBBooaarrdd and its descendants set
                    this value dynamically.  If the widget is a top
                    level window, this value is set to 1.  If it is
                    not a top level window, this value is set to 0.

          XXmmNNssttrriinnggDDiirreeccttiioonn
                    Specifies the initial direction to draw strings.
                    The values are XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__LL__TTOO__RR and
                    XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__RR__TTOO__LL.  The value of this
                    resource is determined at creation time.  If the
                    widget's parent is a manager, this value is
                    inherited from the widget's parent, otherwise it
                    is set to XXmmSSTTRRIINNGG__DDIIRREECCTTIIOONN__LL__TTOO__RR.

          XXmmNNttooppSShhaaddoowwCCoolloorr
                    Specifies the color to use to draw the top and
                    left sides of the border shadow.  This color is
                    used if the XXmmNNttooppSShhaaddoowwPPiixxmmaapp resource is NULL.

          XXmmNNttooppSShhaaddoowwPPiixxmmaapp
                    Specifies the pixmap to use to draw the top and
                    left sides of the border shadow.

          XXmmNNttrraavveerrssaallOOnn
                    Specifies whether traversal is activated for this
                    widget.

          XXmmNNuusseerrDDaattaa
                    Allows the application to attach any necessary
                    specific data to the widget.  This is an
                    internally unused resource.








     2-435                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



        DDyynnaammiicc CCoolloorr DDeeffaauullttss
          The foreground, background, top shadow, and bottom shadow
          resources are dynamically defaulted.  If no color data is
          specified, the colors are automatically generated.  On a
          single-plane system, a black and white color scheme is
          generated.  Otherwise, four colors are generated, which
          display the correct shading for the 3-D visuals.  If the
          background is the only color specified for a widget, the top
          shadow, bottom shadow, and foreground colors are generated
          to give the 3-D appearance.

          Colors are generated only at creation.  Resetting the
          background through XXttSSeettVVaalluueess does not regenerate the other
          colors.

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







     2-436                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



     XmNy                            XmCPosition                     Position         0                      CSG

        CCaallllbbaacckk IInnffoorrmmaattiioonn
          A pointer to the following structure is passed to each
          callback:

          ttyyppeeddeeff ssttrruucctt
          {{
            iinntt          _r_e_a_s_o_n;;
            XXEEvveenntt       * _e_v_e_n_t;;
          }} XXmmAAnnyyCCaallllbbaacckkSSttrruucctt;;


          _r_e_a_s_o_n Indicates why the callback was invoked.  For this
                 callback, _r_e_a_s_o_n is set to XXmmCCRR__HHEELLPP.

          _e_v_e_n_t  Points to the XXEEvveenntt that triggered the callback.


        AAccttiioonn RRoouuttiinneess
          The XmManager action routines are described below:


          MMaannaaggeerrGGaaddggeettAAccttiivvaattee(()):
                    Causes the current gadget to be activated.

          MMaannaaggeerrGGaaddggeettAArrmm(()):
                    Causes the current gadget to be armed.

          MMaannaaggeerrGGaaddggeettBBuuttttoonnMMoottiioonn(()):
                    Causes the current gadget to process a mouse
                    motion event.

          MMaannaaggeerrGGaaddggeettHHeellpp(()):
                    Calls the callbacks for the current gadget's
                    XXmmNNhheellppCCaallllbbaacckk if any exist.  If there are no
                    help callbacks for this widget, this action calls
                    the help callbacks for the nearest ancestor that
                    has them.

          MMaannaaggeerrGGaaddggeettKKeeyyIInnppuutt(()):
                    Causes the current gadget to process a keyboard
                    event.

          MMaannaaggeerrGGaaddggeettMMuullttiiAAccttiivvaattee(()):
                    Causes the current gadget to process a multiple
                    mouse click.

          MMaannaaggeerrGGaaddggeettMMuullttiiAArrmm(()):
                    Causes the current gadget to process a multiple
                    mouse button press.




     2-437                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



          MMaannaaggeerrGGaaddggeettNNeexxttTTaabbGGrroouupp(()):
                    Traverses to the first item in the next tab group.
                    If the current tab group is the last entry in the
                    tab group list, it wraps to the beginning of the
                    tab group list.

          MMaannaaggeerrGGaaddggeettPPrreevvTTaabbGGrroouupp(()):
                    Traverses to the first item in the previous tab
                    group.  If the beginning of the tab group list is
                    reached, it wraps to the end of the tab group
                    list.

          MMaannaaggeerrGGaaddggeettSSeelleecctt(()):
                    Causes the current gadget to be armed and
                    activated.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeDDoowwnn(()):
                    Traverses to the next item below the current
                    gadget in the current tab group, wrapping if
                    necessary.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeHHoommee(()):
                    Traverses to the first widget or gadget in the
                    current tab group.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeLLeefftt(()):
                    Traverses to the next item to the left of the
                    current gadget in the current tab group, wrapping
                    if necessary.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeNNeexxtt(()):
                    Traverses to the next item in the current tab
                    group, wrapping if necessary.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseePPrreevv(()):
                    Traverses to the previous item in the current tab
                    group, wrapping if necessary.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeRRiigghhtt(()):
                    Traverses to the next item to the right of the
                    current gadget in the current tab group, wrapping
                    if necessary.

          MMaannaaggeerrGGaaddggeettTTrraavveerrsseeUUpp(()):
                    Traverses to the next item above the current
                    gadget in the current tab group, wrapping if
                    necessary.

          MMaannaaggeerrPPaarreennttAAccttiivvaattee(()):
                    If the parent is a manager, passes the KKAAccttiivvaattee
                    event received by the current widget/gadget to its
                    parent.



     2-438                                            (printed 5/7/92)






     XXmmMMaannaaggeerr((33XX))            RReeffeerreennccee PPaaggeess            XXmmMMaannaaggeerr((33XX))



          MMaannaaggeerrPPaarreennttCCaanncceell(()):
                    If the parent is a manager, passes the KKCCaanncceell
                    event received by the current widget/gadget to its
                    parent.


     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onnssttrraaiinntt((33XX)), CCoorree((33XX)), and XXmmGGaaddggeett((33XX)).















































     2-439                                            (printed 5/7/92)






     XXmmMMeennuuPPoossiittiioonn((33XX))       RReeffeerreennccee PPaaggeess       XXmmMMeennuuPPoossiittiioonn((33XX))



     NNAAMMEE
          XXmmMMeennuuPPoossiittiioonn-A RowColumn function that positions a Popup
          MenuPane

     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//RRoowwCCoolluummnn..hh>>

          vvooiidd XXmmMMeennuuPPoossiittiioonn ((_m_e_n_u, _e_v_e_n_t))
               WWiiddggeett         _m_e_n_u;;
               XXBBuuttttoonnPPrreesssseeddEEvveenntt* _e_v_e_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMeennuuPPoossiittiioonn positions a Popup MenuPane using the
          information in the specified event.  Unless an application
          is positioning the MenuPane itself, it must first invoke
          this function before managing the PopupMenu.  The _x__r_o_o_t and
          _y__r_o_o_t values in the specified event are used to determine
          the menu position.


          _m_e_n_u   Specifies the PopupMenu to be positioned

          _e_v_e_n_t  Specifies the event passed to the action procedure
                 which manages the PopupMenu


          For a complete definition of RowColumn and its associated
          resources, see XXmmRRoowwCCoolluummnn((33XX)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmRRoowwCCoolluummnn((33XX)).




















     2-440                                            (printed 5/7/92)






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



     NNAAMMEE
          XXmmMMeennuuSShheellll-The MenuShell 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
          and label children (for Trial-use).

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeennuuSShheellll..hh>>


     DDEESSCCRRIIPPTTIIOONN
          The MenuShell widget is a custom OverrideShell widget.  An
          OverrideShell widget bypasses mmwwmm when displaying itself.
          It is designed specifically to contain Popup or Pulldown
          MenuPanes.

          Most application writers never encounter this widget if they
          use the menu-system convenience functions, XXmmCCrreeaatteePPooppuuppMMeennuu
          or XXmmCCrreeaatteePPuullllddoowwnn MMeennuu, to create a Popup or Pulldown
          MenuPane.  The convenience functions automatically create a
          MenuShell widget as the parent of the MenuPane.  However, if
          the convenience functions are not used, the application
          programmer must create the required MenuShell.  In this
          case, it is important to note that the parent of the
          MenuShell depends on the type of menu system being built.


            +o  If the MenuShell is for the top-level Popup MenuPane,
               the MenuShell's parent must be the widget from which
               the Popup MenuPane is popped up.

            +o  If the MenuShell is for a MenuPane that is pulled down
               from a Popup or another Pulldown MenuPane, the
               MenuShell's parent must be the Popup or Pulldown
               MenuPane.

            +o  If the MenuShell is for a MenuPane that is pulled down
               from a MenuBar, the MenuShell's parent must be the
               MenuBar.

            +o  If the MenuShell is for a Pulldown MenuPane in an
               OptionMenu, the MenuShell's parent must be the
               OptionMenu's parent.


          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



     2-441                                            (printed 5/7/92)






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



          MenuShell or its child sets that resource to the same value
          in both the parent and the child.  An application should
          always specify these resources for the child, not the
          parent.

          For the managed child of a MenuShell, 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.

        CCllaasssseess
          MenuShell 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 OOvveerrrriiddeeSShheellll classes.

          The class pointer is xxmmMMeennuuSShheellllWWiiddggeettCCllaassss.

          The class name is XXmmMMeennuuSShheellll.

        NNeeww RReessoouurrcceess
          MenuShell overrides the XXmmNNaalllloowwSShheellllRReessiizzee resource in
          Shell.  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).

                            XXmmMMeennuuS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
     XmNlabelFontList     XmCLabelFontList     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 MenuShell'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



     2-442                                            (printed 5/7/92)






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



                    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,
                    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 MenuShell'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 and
                    XXmmNNllaabbeellF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
                    Specifies the font list used for MenuShell'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.


        IInnhheerriitteedd RReessoouurrcceess
          MenuShell 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
          tables define a set of widget resources used by the
          programmer to specify data.  The programmer can set the
          resource values for these 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



     2-443                                            (printed 5/7/92)






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



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

        AAccttiioonn RRoouuttiinneess
          The XmMenuShell action routines are described below:


          CClleeaarrTTrraavveerrssaall(()):
                    Disables keyboard traversal for the menu, enables
                    mouse traversal, and unposts any menus posted by
                    this menu.



     2-444                                            (printed 5/7/92)






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



          MMeennuuSShheellllPPooppddoowwnnDDoonnee(()):
                    Unposts the menu hierarchy and, when the shell's
                    keyboard focus policy is XXmmEEXXPPLLIICCIITT, restores
                    focus to the widget that had the focus before the
                    menu system was entered.

          MMeennuuSShheellllPPooppddoowwnnOOnnee(()):
                    In a toplevel Pulldown MenuPane from a MenuBar,
                    unposts the menu, disarms the MenuBar
                    CascadeButton and the MenuBar, and, when the
                    shell's keyboard focus policy is XXmmEEXXPPLLIICCTT,
                    restores keyboard focus to the widget that had the
                    focus before the MenuBar was entered.  In other
                    Pulldown MenuPanes, unposts the menu.

                    In a Popup MenuPane, unposts the menu, and, when
                    the shell's keyboard focus policy is XXmmEEXXPPLLIICCTT,
                    restores keyboard focus to the widget from which
                    the menu was posted.


     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)), OOvveerrrriiddeeSShheellll((33XX)), SShheellll((33XX)),
          XXmmCCrreeaatteeMMeennuuSShheellll((33XX)), XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)),
          XXmmCCrreeaatteePPuullllddoowwnn((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).






























     2-445                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



     NNAAMMEE
          XXmmMMeessssaaggeeBBooxx-The MessageBox 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//MMeessssaaggeeBB..hh>>


     DDEESSCCRRIIPPTTIIOONN
          MessageBox is a dialog class used for creating simple
          message dialogs.  Convenience dialogs based on MessageBox
          are provided for several common interaction tasks, which
          include giving information, asking questions, and reporting
          errors.

          A MessageBox dialog is typically transient in nature,
          displayed for the duration of a single interaction.
          MessageBox is a subclass of XmBulletinBoard and depends on
          it for much of its general dialog behavior.

          A typical MessageBox contains a message symbol, a message,
          and up to three standard default PushButtons:  OOKK,, CCaanncceell,
          and HHeellpp.  It is laid out with the symbol and message on top
          and the PushButtons on the bottom.  The help button is
          positioned to the side of the other push buttons.  You can
          localize the default symbols and button labels for
          MessageBox convenience dialogs.

          A MessageBox can also be customized by creating and managing
          new children that are added to the MessageBox children
          created automatically by the convenience dialogs.

          At initialization, MessageBox looks for the following bitmap
          files:


            +o  xm_error

            +o  xm_information

            +o  xm_question

            +o  xm_working

            +o  xm_warning


          See XXmmGGeettPPiixxmmaapp((33XX)) for a list of the paths that are
          searched for these files.




     2-446                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



        CCllaasssseess
          MessageBox inherits behavior and resources from CCoorree,
          CCoommppoossiittee, CCoonnssttrraaiinntt, XXmmMMaannaaggeerr, and XXmmBBuulllleettiinnBBooaarrdd.

          The class pointer is xxmmMMeessssaaggeeBBooxxWWiiddggeettCCllaassss.

          The class name is XXmmMMeessssaaggeeBBooxx.

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

                                       XXmmMMeessssaaggeeBBooxx 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
     _____________________________________________________________________________________________
     XmNcancelCallback      XmCCallback            XtCallbackList   NULL                    C
     XmNcancelLabelString   XmCCancelLabelString   XmString         dynamic                 CSG
     XmNdefaultButtonType   XmCDefaultButtonType   unsigned char    XmDIALOG_OK_BUTTON      CSG
     XmNdialogType          XmCDialogType          unsigned char    XmDIALOG_MESSAGE        CSG
     XmNhelpLabelString     XmCHelpLabelString     XmString         dynamic                 CSG
     XmNmessageAlignment    XmCAlignment           unsigned char    XmALIGNMENT_BEGINNING   CSG
     XmNmessageString       XmCMessageString       XmString         ""                      CSG
     XmNminimizeButtons     XmCMinimizeButtons     Boolean          False                   CSG
     XmNokCallback          XmCCallback            XtCallbackList   NULL                    C
     XmNokLabelString       XmCOkLabelString       XmString         dynamic                 CSG
     XmNsymbolPixmap        XmCPixmap              Pixmap           dynamic                 CSG


















     2-447                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



          XXmmNNccaanncceellCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    when the user clicks on the cancel button.  The
                    reason sent by the callback is XXmmCCRR__CCAANNCCEELL.

          XXmmNNccaanncceellLLaabbeellSSttrriinngg
                    Specifies the string label for the cancel button.
                    The default for this resource depends on the
                    locale.  In the C locale the default is "Cancel".

          XXmmNNddeeffaauullttBBuuttttoonnTTyyppee
                    Specifies the default PushButton.  A value of
                    XXmmDDIIAALLOOGG__NNOONNEE means that there should be no
                    default PushButton.  The following are valid
                    types:


                      +o  XXmmDDIIAALLOOGG__CCAANNCCEELL__BBUUTTTTOONN

                      +o  XXmmDDIIAALLOOGG__OOKK__BBUUTTTTOONN

                      +o  XXmmDDIIAALLOOGG__HHEELLPP__BBUUTTTTOONN

                      +o  XXmmDDIIAALLOOGG__NNOONNEE


          XXmmNNddiiaallooggTTyyppee
                    Specifies the type of MessageBox dialog, which
                    determines the default message symbol.  The
                    following are the possible values for this
                    resource:


                      +o  XXmmDDIIAALLOOGG__EERRRROORR-indicates an ErrorDialog

                      +o  XXmmDDIIAALLOOGG__IINNFFOORRMMAATTIIOONN-indicates an
                         InformationDialog

                      +o  XXmmDDIIAALLOOGG__MMEESSSSAAGGEE-indicates a MessageDialog.
                         This is the default MessageBox dialog type.
                         The default message symbol is NULL.

                      +o  XXmmDDIIAALLOOGG__QQUUEESSTTIIOONN-indicates a QuestionDialog

                      +o  XXmmDDIIAALLOOGG__WWAARRNNIINNGG-indicates a WarningDialog

                      +o  XXmmDDIIAALLOOGG__WWOORRKKIINNGG-indicates a WorkingDialog


                    If this resource is changed via XXttSSeettVVaalluueess, the
                    symbol bitmap is modified to the new XXmmNNddiiaallooggTTyyppee
                    bitmap unless XXmmNNssyymmbboollPPiixxmmaapp is also being set in



     2-448                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



                    the call to XXttSSeettVVaalluueess.

          XXmmNNhheellppLLaabbeellSSttrriinngg
                    Specifies the string label for the help button.
                    The default for this resource depends on the
                    locale.  In the C locale the default is "Help".

          XXmmNNmmeessssaaggeeAAlliiggnnmmeenntt
                    Controls the alignment of the message Label.
                    Possible values include the following:


                      +o  XXmmAALLIIGGNNMMEENNTT__BBEEGGIINNNNIINNGG-the default

                      +o  XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR

                      +o  XXmmAALLIIGGNNMMEENNTT__EENNDD


          XXmmNNmmeessssaaggeeSSttrriinngg
                    Specifies the string to be used as the message.

          XXmmNNmmiinniimmiizzeeBBuuttttoonnss
                    Sets the buttons to the width of the widest button
                    and height of the tallest button if False.  If
                    True, button width and height are set to the
                    preferred size of each button.

          XXmmNNookkCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    when the user clicks on the OK button.  The reason
                    sent by the callback is XXmmCCRR__OOKK.

          XXmmNNookkLLaabbeellSSttrriinngg
                    Specifies the string label for the OK button.  The
                    default for this resource depends on the locale.
                    In the C locale the default is "OK".

          XXmmNNssyymmbboollPPiixxmmaapp
                    Specifies the pixmap label to be used as the
                    message symbol.


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

                                XXmmBBuulllleettiinnBBooaarrdd RReessoouurrccee SSeett






     2-449                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((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
     __________________________________________________________________________________
     XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
     XmNautoUnmanage       XmCAutoUnmanage      Boolean          True            CG
     XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         CSG
     XmNcancelButton       XmCWidget            Widget           Cancel button   SG
     XmNdefaultButton      XmCWidget            Widget           dynamic         SG
     XmNdefaultPosition    XmCDefaultPosition   Boolean          True            CSG
     XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
     XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
     XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
     XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
     XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
     XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG
     XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
     XmNnoResize           XmCNoResize          Boolean          False           CSG
     XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY    CSG
     XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
     XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
     XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
     XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C

                                          XXmmMMaannaaggeerr 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
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
     XmNuserData             XmCUserData             XtPointer           NULL                   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-450                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
     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        0                      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

        CCaallllbbaacckk IInnffoorrmmaattiioonn
          A pointer to the following structure is passed to each
          callback:

          ttyyppeeddeeff ssttrruucctt
          {{
            iinntt          _r_e_a_s_o_n;;
            XXEEvveenntt       * _e_v_e_n_t;;
          }} XXmmAAnnyyCCaallllbbaacckkSSttrruucctt;;


          _r_e_a_s_o_n Indicates why the callback was invoked

          _e_v_e_n_t  Points to the XXEEvveenntt that triggered the callback




















     2-451                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxx((33XX))         RReeffeerreennccee PPaaggeess         XXmmMMeessssaaggeeBBooxx((33XX))



     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onnssttrraaiinntt((33XX)), CCoorree((33XX)),
          XXmmBBuulllleettiinnBBooaarrdd((33XX)), XXmmCCrreeaatteeEErrrroorrDDiiaalloogg((33XX)),
          XXmmCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg((33XX)), XXmmCCrreeaatteeMMeessssaaggeeBBooxx((33XX)),
          XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg((33XX)), XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg((33XX)),
          XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg((33XX)), XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg((33XX)),
          XXmmMMaannaaggeerr((33XX)), and XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX)).
















































     2-452                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX)) RReeffeerreennccee PPaaggeess XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX))



     NNAAMMEE
          XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd-A MessageBox function that is used to
          access a component

     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//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd ((_w_i_d_g_e_t, _c_h_i_l_d))
               WWiiddggeett    _w_i_d_g_e_t;;
               uunnssiiggnneedd cchhaarr_c_h_i_l_d;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd is used to access a component within a
          MessageBox.  The parameters given to the function are the
          MessageBox widget and a value indicating which component to
          access.


          _w_i_d_g_e_t Specifies the MessageBox widget ID.

          _c_h_i_l_d  Specifies a component within the MessageBox.  The
                 following are legal values for this parameter:


                   +o  XXmmDDIIAALLOOGG__CCAANNCCEELL__BBUUTTTTOONN

                   +o  XXmmDDIIAALLOOGG__DDEEFFAAUULLTT__BBUUTTTTOONN

                   +o  XXmmDDIIAALLOOGG__HHEELLPP__BBUUTTTTOONN

                   +o  XXmmDDIIAALLOOGG__MMEESSSSAAGGEE__LLAABBEELL

                   +o  XXmmDDIIAALLOOGG__OOKK__BBUUTTTTOONN

                   +o  XXmmDDIIAALLOOGG__SSEEPPAARRAATTOORR

                   +o  XXmmDDIIAALLOOGG__SSYYMMBBOOLL__LLAABBEELL


          For a complete definition of MessageBox and its associated
          resources, see XXmmMMeessssaaggeeBBooxx((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID of the specified MessageBox component.
          An application should not assume that the returned widget
          will be of any particular class.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN



     2-453                                            (printed 5/7/92)






     XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX)) RReeffeerreennccee PPaaggeess XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX))



          XXmmMMeessssaaggeeBBooxx((33XX)).






















































     2-454                                            (printed 5/7/92)






     XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX)) RReeffeerreennccee PPaaggeess XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmOOppttiioonnBBuuttttoonnGGaaddggeett-A RowColumn function that obtains the
          widget ID for the CascadeButtonGadget in an OptionMenu

     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//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXmmOOppttiioonnBBuuttttoonnGGaaddggeett ((_o_p_t_i_o_n__m_e_n_u))
               WWiiddggeett    _o_p_t_i_o_n__m_e_n_u;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmOOppttiioonnBBuuttttoonnGGaaddggeett provides the application with the means
          for obtaining the widget ID for the internally created
          CascadeButtonGadget.  Once the application has obtained the
          widget ID, it can adjust the visuals for the
          CascadeButtonGadget, if desired.

          When an application creates an instance of the OptionMenu
          widget, the widget creates two internal gadgets.  One is a
          LabelGadget that is used to display RowColumn's
          XXmmNNllaabbeellSSttrriinngg resource.  The other is a CascadeButtonGadget
          that displays the current selection and provides the means
          for posting the OptionMenu's submenu.


          _o_p_t_i_o_n__m_e_n_u
                    Specifies the OptionMenu widget ID


          For a complete definition of RowColumn and its associated
          resources, see XXmmRRoowwCCoolluummnn((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID for the internal button.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)),
          XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).













     2-455                                            (printed 5/7/92)






     XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX))  RReeffeerreennccee PPaaggeess  XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX))



     NNAAMMEE
          XXmmOOppttiioonnLLaabbeellGGaaddggeett-A RowColumn function that obtains the
          widget ID for the LabelGadget in an OptionMenu

     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//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXmmOOppttiioonnLLaabbeellGGaaddggeett ((_o_p_t_i_o_n__m_e_n_u))
               WWiiddggeett    _o_p_t_i_o_n__m_e_n_u;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmOOppttiioonnLLaabbeellGGaaddggeett provides the application with the means
          for obtaining the widget ID for the internally created
          LabelGadget.  Once the application has obtained the widget
          ID, it can adjust the visuals for the LabelGadget, if
          desired.

          When an application creates an instance of the OptionMenu
          widget, the widget creates two internal gadgets.  One is a
          LabelGadget that is used to display RowColumn's
          XXmmNNllaabbeellSSttrriinngg resource.  The other is a CascadeButtonGadget
          that displays the current selection and provides the means
          for posting the OptionMenu's submenu.


          _o_p_t_i_o_n__m_e_n_u
                    Specifies the OptionMenu widget ID


          For a complete definition of RowColumn and its associated
          resources, see XXmmRRoowwCCoolluummnn((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID for the internal label.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmLLaabbeellGGaaddggeett((33XX)),
          XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).













     2-456                                            (printed 5/7/92)



 d
