


                                                             XmMainWindow(3X)



   NAME
     XXmmMMaaiinnWWiinnddooww-The MainWindow widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>

   DESCRIPTION
     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 Scrol-
     ledWindow with an optional MenuBar and optional CommandWindow and Mes-
     sageWindow.

     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 ScrolledWin-
     dow.  The behavior of ScrolledWindow can be controlled by the Scrol-
     ledWindow resources.  To create a MainWindow, first create the work
     region elements, a MenuBar, a CommandWindow, a MessageWindow, a horizon-
     tal ScrollBar, and a vertical ScrollBar widget, and then call XXmmMMaaiinnWWiinn--
     d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.

     Classes

     MainWindow inherits behavior and resources from CCoorree, CCoommppoossiittee, CCoonn--
     s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.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),


   2-377






   XmMainWindow(3X)


     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 MainWin-
               dow.  This resource overrides any setting of the ScrolledWin-
               dow 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 Scrol-
               ledWindow 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.

     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.





   2-378






                                                             XmMainWindow(3X)


     Inherited Resources

     MainWindow inherits behavior and resources from the following superc-
     lasses.  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
   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


   2-379






   XmMainWindow(3X)


   XmNheight                       XmCHeight                       Dimension        dynamic                CSG
   XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
   XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
   XmNscreen                       XmCScreen                       Screen *         dynamic                CG
   XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
   XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCo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-380






                                                         XmMainWindowSep1(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   HISTORY/DIRECTION
     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.

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 Menu-
     Bar 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)).

   RETURN VALUE
     Returns the widget ID of the first Separator.

   RELATED INFORMATION
     XXmmMMaaiinnWWiinnddooww((33XX)).
























   2-381






   XmMainWindowSep2(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   HISTORY/DIRECTION
     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.

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 Com-
     mand 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)).

   RETURN VALUE
     Returns the widget ID of the second Separator.

   RELATED INFORMATION
     XXmmMMaaiinnWWiinnddooww((33XX)).
























   2-382






                                                         XmMainWindowSep3(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   HISTORY/DIRECTION
     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.

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 mes-
     sage 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)).

   RETURN VALUE
     Returns the widget ID of the third Separator.

   RELATED INFORMATION
     XXmmMMaaiinnWWiinnddooww((33XX)).
























   2-383






   XmMainWindowSetAreas(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 win-
     dow, 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 associ-
                 ated with the MainWindow widget.  Set this ID only after
                 creating an instance of the MainWindow widget.  The attri-
                 bute 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 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


   2-384






                                                     XmMainWindowSetAreas(3X)


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

   RELATED INFORMATION
     XXmmMMaaiinnWWiinnddooww((33XX)).












































   2-385






   XmManager(3X)



   NAME
     XXmmMMaannaaggeerr-The Manager widget class

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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 mechan-
     isms.

     Classes

     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n--
     s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.

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                        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
   XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
   XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
   XmNuserData             XmCUserData             XtPointer           NULL                   CSG


   2-386






                                                                XmManager(3X)



     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a--
               d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 widg-
               ets.

     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o  XXmmNNOONNEE indicates that the widget is not a tab group.

                 ++o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a--
                    t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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 XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP.

                 ++o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a--
                    t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l--
               l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.



   2-387






   XmManager(3X)


     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x--
               m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.

     Dynamic Color Defaults

     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.

     Inherited Resources

     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


   2-388






                                                                XmManager(3X)


   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

     Callback Information

     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.

     Action Routines

     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(()):


   2-389






   XmManager(3X)


               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.

     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, wrap-
               ping 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.

     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.


   2-390






                                                                XmManager(3X)



   RELATED INFORMATION
     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-391






   XmMenuPosition(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 Popup-
     Menu.  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)).

   RELATED INFORMATION
     XXmmRRoowwCCoolluummnn((33XX)).


























   2-392






                                                              XmMenuShell(3X)



   NAME
     XXmmMMeennuuSShheellll-The MenuShell widget class

   AES SUPPORT LEVEL
     Full-use

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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeennuuSShheellll..hh>>

   DESCRIPTION
     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 pro-
     grammer must create the required MenuShell.  In this case, it is impor-
     tant to note that the parent of the MenuShell depends on the type of
     menu system being built.

       ++o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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o  If the MenuShell is for a MenuPane that is pulled down from a Menu-
          Bar, the MenuShell's parent must be the MenuBar.

       ++o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 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 coordi-
     nates of the child's upper left outside corner relative to the parent's


   2-393






   XmMenuShell(3X)


     upper left inside corner are both zero minus the value of XXmmNNbboorr--
     ddeerrWWiiddtthh.

     Classes

     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.

     New Resources

     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 fol-
     lowing 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t--
     V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 descen-
               dants.  If this value is NULL at initialization and if the
               value of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is
               initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the value
               of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initial-
               ized by looking up the parent hierarchy of the widget for an
               ancestor that is a subclass of the XmBulletinBoard, Vendor-
               Shell, or XmMenuShell widget class.  If such an ancestor is
               found, XXmmNNbbuuttttoonnFFoonnttLLiisstt is initialized to the XXmmNNbbuuttttoonn--
               FFoonnttLLiisstt of the ancestor  widget.  If no such ancestor is
               found, the default is implementation dependent.

     XXmmNNddeeffaauullttFFoonnttLLiisstt
               Specifies a default font list for 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


   2-394






                                                              XmMenuShell(3X)


               (Labels and LabelGadgets).  If this value is NULL at initiali-
               zation 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t--
               F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a--
               b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 XmBul-
               letinBoard, 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.

     Inherited Resources

     MenuShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.  The following 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 .Xde-
     faults 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                  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


   2-395






   XmMenuShell(3X)


   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

     Action Routines

     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.

     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.

   RELATED INFORMATION
     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-396






                                                             XmMessageBox(3X)



   NAME
     XXmmMMeessssaaggeeBBooxx-The MessageBox widget class

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

   DESCRIPTION
     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 XmBul-
     letinBoard 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 bot-
     tom.  The help button is positioned to the side of the other push but-
     tons.  You can localize the default symbols and button labels for Mes-
     sageBox convenience dialogs.

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

     At initialization, MessageBox looks for the following bitmap files:

       ++oo  xm_error

       ++oo  xm_information

       ++oo  xm_question

       ++oo  xm_working

       ++o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.

     Classes

     MessageBox inherits behavior and resources from CCoorree, CCoommppoossiittee, CCoonn--
     s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.




   2-397






   XmMessageBox(3X)


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

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                     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

     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 follow-
               ing are valid types:

                 ++o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o  XXmmDDIIAALLOOGG__OOKK__BBUUTTTTOONN

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

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


   2-398






                                                             XmMessageBox(3X)


               Specifies the type of MessageBox dialog, which determines the
               default message symbol.  The following are the possible values
               for this resource:

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

                 ++o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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 sym-
                    bol is NULL.

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

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

                 ++o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l--
               PPiixxmmaapp is also being set in 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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o  XXmmAALLIIGGNNMMEENNTT__CCEENNTTEERR

                 ++o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".



   2-399






   XmMessageBox(3X)


     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.

     Inherited Resources

     MessageBox inherits behavior and resources from the following superc-
     lasses.  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
   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-400






                                                             XmMessageBox(3X)


   ______________________________________________________________________________________________________________
   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

     Callback Information

     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

   RELATED INFORMATION
     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-401






   XmMessageBoxGetChild(3X)



   NAME
     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 com-
     ponent

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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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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o  XXmmDDIIAALLOOGG__HHEELLPP__BBUUTTTTOONN

              ++o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o  XXmmDDIIAALLOOGG__OOKK__BBUUTTTTOONN

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

              ++o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)).

   RETURN VALUE
     Returns the widget ID of the specified MessageBox component.  An appli-
     cation should not assume that the returned widget will be of any partic-
     ular class.

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








   2-402






                                                     XmOptionButtonGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 obtain-
     ing 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 Cascade-
     ButtonGadget 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)).

   RETURN VALUE
     Returns the widget ID for the internal button.

   RELATED INFORMATION
     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-403






   XmOptionLabelGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##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;;

   DESCRIPTION
     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 obtain-
     ing 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 Cascade-
     ButtonGadget 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)).

   RETURN VALUE
     Returns the widget ID for the internal label.

   RELATED INFORMATION
     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-404



 )
