


     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((33XX))



     NNAAMMEE
          XXmmCCoommmmaanndd-The Command widget class

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>


     DDEESSCCRRIIPPTTIIOONN
          Command is a special-purpose composite widget for command
          entry that provides a built-in command-history mechanism.
          Command includes a command-line text-input field, a
          command-line prompt, and a command-history list region.

          One additional WWoorrkkAArreeaa child may be added to the Command
          after creation.

          Whenever a command is entered, it is automatically added to
          the end of the command-history list and made visible.  This
          does not change the selected item in the list, if there is
          one.

          Many of the new resources specified for Command are actually
          SelectionBox resources that have been renamed for clarity
          and ease of use.

        CCllaasssseess
          Command 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, XXmmBBuulllleettiinnBBooaarrdd, and
          XXmmSSeelleeccttiioonnBBooxx classes.

          The class pointer is xxmmCCoommmmaannddWWiiddggeettCCllaassss.

          The class name is XXmmCCoommmmaanndd.

        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mCCoommmmaanndd RReessoouurrccee SSeett





     1-222                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((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
     ____________________________________________________________________________________
     XmNcommand                   XmCTextString         XmString         ""        CSG
     XmNcommandChangedCallback    XmCCallback           XtCallbackList   NULL      C
     XmNcommandEnteredCallback    XmCCallback           XtCallbackList   NULL      C
     XmNhistoryItems              XmCItems              XmStringTable    NULL      CSG
     XmNhistoryItemCount          XmCItemCount          int              0         CSG
     XmNhistoryMaxItems           XmCMaxItems           int              100       CSG
     XmNhistoryVisibleItemCount   XmCVisibleItemCount   int              dynamic   CSG
     XmNpromptString              XmCPromptString       XmString         dynamic   CSG


          XXmmNNccoommmmaanndd
                    Contains the current command-line text.  This is
                    the XXmmNNtteexxttSSttrriinngg resource in SelectionBox,
                    renamed for Command.  This resource can also be
                    modified via XXmmCCoommmmaannddSSeettVVaalluuee and
                    XXmmCCoommmmaannddAAppppeennddVVaalluuee functions.  The command area
                    is a Text widget.

          XXmmNNccoommmmaannddCChhaannggeeddCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    when the value of the command changes.  The
                    callback reason is XXmmCCRR__CCOOMMMMAANNDD__CCHHAANNGGEEDD.  This is
                    equivalent to the XXmmNNvvaalluueeCChhaannggeeddCCaallllbbaacckk of the
                    Text widget, except that a pointer to an
                    XXmmCCoommmmaannddCCaallllbbaacckkSSttrruuccttuurree is passed, and the
                    structure's _v_a_l_u_e member contains the XXmmSSttrriinngg.

          XXmmNNccoommmmaannddEEnntteerreeddCCaallllbbaacckk
                    Specifies the list of callbacks that is called
                    when a command is entered in the Command.  The
                    callback reason is XXmmCCRR__CCOOMMMMAANNDD__EENNTTEERREEDD.  A
                    pointer to an XXmmCCoommmmaannddCCaallllbbaacckk structure is
                    passed.

          XXmmNNhhiissttoorryyIItteemmss
                    Lists XXmmSSttrriinngg items that make up the contents of
                    the history list.  This is the XXmmNNlliissttIItteemmss
                    resource in SelectionBox, renamed for Command.
                    XXttGGeettVVaalluueess for this resource returns the list
                    items themselves, not a copy of the list items.
                    The application must not free the returned items.

          XXmmNNhhiissttoorryyIItteemmCCoouunntt
                    Specifies the number of XXmmSSttrriinnggss in
                    XXmmNNhhiissttoorryyIItteemmss.  This is the XXmmNNlliissttIItteemmCCoouunntt
                    resource in SelectionBox, renamed for Command.
                    The value must not be negative.

          XXmmNNhhiissttoorryyMMaaxxIItteemmss
                    Specifies the maximum number of items allowed in



     1-223                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((33XX))



                    the history list.  Once this number is reached, an
                    existing list item must be removed before a new
                    item can be added to the list.  For each command
                    entered, the first list item is removed from the
                    list, so the new command can be added to the list.
                    The value must be greater than 0.

          XXmmNNhhiissttoorryyVViissiibblleeIItteemmCCoouunntt
                    Specifies the number of items in the history list
                    that should be visible at one time.  In effect, it
                    sets the height (in lines) of the history list
                    window.  This is the XXmmNNlliissttVViissiibblleeIItteemmCCoouunntt
                    resource in SelectionBox, renamed for Command.
                    The value must be greater than 0.  The default is
                    dynamic based on the height of the list.

          XXmmNNpprroommppttSSttrriinngg
                    Specifies a prompt for the command line.  This is
                    the XXmmNNsseelleeccttiioonnLLaabbeellSSttrriinngg resource in
                    SelectionBox, renamed for Command.  The default
                    may vary depending on the value of the
                    XXmmNNssttrriinnggDDiirreeccttiioonn resource and the locale.  In
                    the C locale the default is ">".


        IInnhheerriitteedd RReessoouurrcceess
          Command 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SeelleeccttiioonnB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
     _____________________________________________________________________________________________________
     XmNapplyCallback          XmCCallback               XtCallbackList   NULL                      N/A
     XmNapplyLabelString       XmCApplyLabelString       XmString         dynamic                   N/A
     XmNcancelCallback         XmCCallback               XtCallbackList   NULL                      N/A
     XmNcancelLabelString      XmCCancelLabelString      XmString         dynamic                   N/A
     XmNchildPlacement         XmCChildPlacement         unsigned char    XmPLACE_ABOVE_SELECTION   CSG
     XmNdialogType             XmCDialogType             unsigned char    XmDIALOG_COMMAND          G
     XmNhelpLabelString        XmCHelpLabelString        XmString         dynamic                   N/A
     XmNlistItemCount          XmCItemCount              int              0                         CSG
     XmNlistItems              XmCItems                  XmStringTable    NULL                      CSG
     XmNlistLabelString        XmCListLabelString        XmString         NULL                      N/A
     XmNlistVisibleItemCount   XmCVisibleItemCount       int              dynamic                   CSG
     XmNminimizeButtons        XmCMinimizeButtons        Boolean          False                     N/A
     XmNmustMatch              XmCMustMatch              Boolean          False                     N/A
     XmNnoMatchCallback        XmCCallback               XtCallbackList   NULL                      N/A
     XmNokCallback             XmCCallback               XtCallbackList   NULL                      N/A







     1-224                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((33XX))



     XmNokLabelString          XmCOkLabelString          XmString         dynamic                   N/A
     XmNselectionLabelString   XmCSelectionLabelString   XmString         dynamic                   CSG
     XmNtextAccelerators       XmCTextAccelerators       XtAccelerators   default                   C
     XmNtextColumns            XmCColumns                short            dynamic                   CSG
     XmNtextString             XmCTextString             XmString         ""                        CSG

                                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          False           N/A
     XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         N/A
     XmNcancelButton       XmCWidget            Widget           NULL            N/A
     XmNdefaultButton      XmCWidget            Widget           NULL            N/A
     XmNdefaultPosition    XmCDefaultPosition   Boolean          False           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_NONE   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
     XmNinitialFocus         XmCInitialFocus         Widget              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
     XmNunitType             XmCUnitType             unsigned char       dynamic                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






     1-225                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((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
     ______________________________________________________________________
     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                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mSSttrriinngg _v_a_l_u_e;;
            iinntt      _l_e_n_g_t_h;;
          }} XXmmCCoommmmaannddC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

          _v_a_l_u_e  Specifies the XXmmSSttrriinngg in the CommandArea

          _l_e_n_g_t_h Specifies the size of the command in XXmmSSttrriinngg


        TTrraannssllaattiioonnss



     1-226                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((33XX))



          XmCommand inherits translations from XmSelectionBox.

        AAcccceelleerraattoorrss
          The XXmmNNtteexxttAAcccceelleerraattoorrss from XmSelectionBox are added to the
          Text descendant of XmCommand.

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


          SSeelleeccttiioonnBBooxxUUppOOrrDDoowwnn((00||11||22||33)):
                    When called with a 0 argument, selects the
                    previous item in the history list and replaces the
                    text with that item.

                    When called with a 1 argument, selects the next
                    item in the history list and replaces the text
                    with that item.

                    When called with a 2 argument, selects the first
                    item in the history list and replaces the text
                    with that item.

                    When called with a 3 argument, selects the last
                    item in the history list and replaces the text
                    with that item.

                    Calls the callbacks for XXmmNNccoommmmaannddCChhaannggeeddCCaallllbbaacckk.


        AAddddiittiioonnaall BBeehhaavviioorr
          The Command widget has the additional behavior described
          below:


          MMAAnnyy KKCCaanncceell:
                    If the parent of the Command is a manager, the
                    event is passed to the parent.

          KKAAccttiivvaattee in Text:
                    Calls the Text widget's XXmmNNaaccttiivvaatteeCCaallllbbaacckk
                    callbacks.  If the text is empty, this action then
                    returns.  Otherwise, if the history list has
                    XXmmNNhhiissttoorryyMMaaxxIItteemmss items, it removes the first
                    item in the list.  It adds the text to the history
                    list as the last item, clears the text, and calls
                    the XXmmNNccoommmmaannddEEnntteerreeddCCaallllbbaacckk callbacks.

          <<KKeeyy>> in Text:
                    When any change is made to the text edit widget,
                    this action calls the callbacks for
                    XXmmNNccoommmmaannddCChhaannggeeddCCaallllbbaacckk.



     1-227                                            (printed 5/7/92)






     XXmmCCoommmmaanndd((33XX))            RReeffeerreennccee PPaaggeess            XXmmCCoommmmaanndd((33XX))



          <<DDoouubblleeCClliicckk>> or <<KKAAccttiivvaattee>> in List:
                    Calls the List widget's XXmmNNddeeffaauullttAAccttiioonnCCaallllbbaacckk
                    callbacks.  If the history list has
                    XXmmNNhhiissttoorryyMMaaxxIItteemmss items, this action removes the
                    first item in the list.  It adds the selected List
                    item to the history list as the last item, clears
                    the text, and calls the XXmmNNccoommmmaannddEEnntteerreeddCCaallllbbaacckk
                    callbacks.

          <<FFooccuussIInn>>:
                    Calls the callbacks for XXmmNNffooccuussCCaallllbbaacckk.

          <<MMaappWWiinnddooww>>:
                    When a Command that is the child of a DialogShell
                    is mapped, this action calls the callbacks for
                    XXmmNNmmaappCCaallllbbaacckk.

          <<UUnnmmaappWWiinnddooww>>:
                    When a Command that is the child of a DialogShell
                    is unmapped, this action calls the callbacks for
                    XXmmNNuunnmmaappCCaallllbbaacckk.


        VViirrttuuaall BBiinnddiinnggss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VViirrttuuaallBBiinnddiinnggss((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CoommmmaannddAAppppeennddVVaalluuee((33XX)),
          XXmmCCoommmmaannddEErrrroorr((33XX)), XXmmCCoommmmaannddGGeettCChhiilldd((33XX)),
          XXmmCCoommmmaannddSSeettVVaalluuee((33XX)), XXmmCCrreeaatteeCCoommmmaanndd((33XX)), XXmmMMaannaaggeerr((33XX)),
          and XXmmSSeelleeccttiioonnBBooxx((33XX)).





















     1-228                                            (printed 5/7/92)






     XXmmCCoommmmaannddAAppppeennddVVaalluuee((33XX)) RReeffeerreennccee PPaaggeess XXmmCCoommmmaannddAAppppeennddVVaalluuee((33XX))



     NNAAMMEE
          XXmmCCoommmmaannddAAppppeennddVVaalluuee-A Command function that appends the
          passed XmString to the end of the string displayed in the
          command area of the widget

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

          vvooiidd XXmmCCoommmmaannddAAppppeennddVVaalluuee ((_w_i_d_g_e_t, _c_o_m_m_a_n_d))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _c_o_m_m_a_n_d;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCoommmmaannddAAppppeennddVVaalluuee appends the passed XXmmSSttrriinngg to the end
          of the string displayed in the command area of the Command
          widget.


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

          _c_o_m_m_a_n_dSpecifies the passed XXmmSSttrriinngg


          For a complete definition of Command and its associated
          resources, see XXmmCCoommmmaanndd((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mCCoommmmaanndd((33XX)).


























     1-229                                            (printed 5/7/92)






     XXmmCCoommmmaannddEErrrroorr((33XX))       RReeffeerreennccee PPaaggeess       XXmmCCoommmmaannddEErrrroorr((33XX))



     NNAAMMEE
          XXmmCCoommmmaannddEErrrroorr-A Command function that displays an error
          message

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

          vvooiidd XXmmCCoommmmaannddEErrrroorr ((_w_i_d_g_e_t, _e_r_r_o_r))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _e_r_r_o_r;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCoommmmaannddEErrrroorr displays an error message in the history area
          of the Command widget.  The XXmmSSttrriinngg error is displayed
          until the next command entered occurs.


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

          _e_r_r_o_r  Specifies the passed XXmmSSttrriinngg


          For a complete definition of Command and its associated
          resources, see XXmmCCoommmmaanndd((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mCCoommmmaanndd((33XX)).



























     1-230                                            (printed 5/7/92)






     XXmmCCoommmmaannddG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mCCoommmmaannddGGeettCChhiilldd((33XX))



     NNAAMMEE
          XXmmCCoommmmaannddGGeettCChhiilldd-A Command function that is used to access
          a component

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

          WWiiddggeett XXmmCCoommmmaannddG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mCCoommmmaannddGGeettCChhiilldd is used to access a component within a
          Command.  The parameters given to the function are the
          Command widget and a value indicating which component to
          access.


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

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


                   +o  XXmmDDIIAALLOOGG__CCOOMMMMAANNDD__TTEEXXTT

                   +o  XXmmDDIIAALLOOGG__PPRROOMMPPTT__LLAABBEELL

                   +o  XXmmDDIIAALLOOGG__HHIISSTTOORRYY__LLIISSTT

                   +o  XXmmDDIIAALLOOGG__WWOORRKK__AARREEAA


          For a complete definition of Command and its associated
          resources, see XXmmCCoommmmaanndd((33XX)).

     RREETTUURRNN VVAALLUUEE
          Returns the widget ID of the specified Command 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
          XXmmCCoommmmaanndd((33XX)).











     1-231                                            (printed 5/7/92)






     XXmmCCoommmmaannddSSeettVVaalluuee((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCoommmmaannddSSeettVVaalluuee((33XX))



     NNAAMMEE
          XXmmCCoommmmaannddSSeettVVaalluuee-A Command function that replaces a
          displayed string

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

          vvooiidd XXmmCCoommmmaannddSSeettVVaalluuee ((_w_i_d_g_e_t, _c_o_m_m_a_n_d))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _c_o_m_m_a_n_d;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCoommmmaannddSSeettVVaalluuee replaces the string displayed in the
          command area of the Command widget with the passed XXmmSSttrriinngg.


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

          _c_o_m_m_a_n_dSpecifies the passed XXmmSSttrriinngg


          For a complete definition of Command and its associated
          resources, see XXmmCCoommmmaanndd((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mCCoommmmaanndd((33XX)).




























     1-232                                            (printed 5/7/92)






     XXmmCCoonnvveerrttUUnniittss((33XX))       RReeffeerreennccee PPaaggeess       XXmmCCoonnvveerrttUUnniittss((33XX))



     NNAAMMEE
          XXmmCCoonnvveerrttUUnniittss-A function that converts a value in one unit
          type to another unit type

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

          iinntt XXmmCCoonnvveerrttUUnniittss ((_w_i_d_g_e_t, _o_r_i_e_n_t_a_t_i_o_n, _f_r_o_m__u_n_i_t__t_y_p_e,
                    _f_r_o_m__v_a_l_u_e, _t_o__u_n_i_t__t_y_p_e))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _o_r_i_e_n_t_a_t_i_o_n;;
               iinntt       _f_r_o_m__u_n_i_t__t_y_p_e;;
               iinntt       _f_r_o_m__v_a_l_u_e;;
               iinntt       _t_o__u_n_i_t__t_y_p_e;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCoonnvveerrttUUnniittss converts the value and returns it as the
          return value from the function.


          _w_i_d_g_e_t      Specifies the widget for which the data is to be
                      converted

          _o_r_i_e_n_t_a_t_i_o_n Specifies whether the converter uses the
                      horizontal or vertical screen resolution when
                      performing the conversions.  _o_r_i_e_n_t_a_t_i_o_n can
                      have values of XXmmHHOORRIIZZOONNTTAALL or XXmmVVEERRTTIICCAALL.

          _f_r_o_m__u_n_i_t__t_y_p_e
                      Specifies the current unit type of the supplied
                      value

          _f_r_o_m__v_a_l_u_e  Specifies the value to be converted

          _t_o__u_n_i_t__t_y_p_e
                      Converts the value to the unit type specified


          The parameters _f_r_o_m__u_n_i_t__t_y_p_e and _t_o__u_n_i_t__t_y_p_e can have the
          following values:


            +o  XXmmPPIIXXEELLSS-all values provided to the widget are treated
               as normal pixel values.  This is the default for the
               resource.

            +o  XXmm110000TTHH__MMIILLLLIIMMEETTEERRSS-all values provided to the widget
               are treated as 1/100 millimeter.

            +o  XXmm11000000TTHH__IINNCCHHEESS-all values provided to the widget are
               treated as 1/1000 inch.



     1-233                                            (printed 5/7/92)






     XXmmCCoonnvveerrttUUnniittss((33XX))       RReeffeerreennccee PPaaggeess       XXmmCCoonnvveerrttUUnniittss((33XX))



            +o  XXmm110000TTHH__PPOOIINNTTSS-all values provided to the widget are
               treated as 1/100 point.  A point is a unit typically
               used in text processing applications and is defined as
               1/72 inch.

            +o  XXmm110000TTHH__FFOONNTT__UUNNIITTSS-all values provided to the widget
               are treated as 1/100 of a font unit.  A font unit has
               horizontal and vertical components.  These are the
               values of the XmScreen resources XXmmNNhhoorriizzoonnttaallFFoonnttUUnniitt
               and XXmmNNvveerrttiiccaallFFoonnttUUnniitt.


     RREETTUURRNN VVAALLUUEE
          Returns the converted value.  If a NULL widget, incorrect
          _o_r_i_e_n_t_a_t_i_o_n, or incorrect _u_n_i_t__t_y_p_e is supplied as parameter
          data, 0 is returned.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSeettFFoonnttUUnniittss((33XX)) and XXmmSSccrreeeenn((33XX)).




































     1-234                                            (printed 5/7/92)






     XXmmCCrreeaatteeAArrrroowwBBuuttttoonn((33XX))  RReeffeerreennccee PPaaggeess  XXmmCCrreeaatteeAArrrroowwBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeAArrrroowwBBuuttttoonn-The ArrowButton widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//AArrrroowwBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeAArrrroowwBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeAArrrroowwBBuuttttoonn creates an instance of an ArrowButton
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ArrowButton and its associated
          resources, see XXmmAArrrroowwBBuuttttoonn((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmAArrrroowwBBuuttttoonn((33XX)).


















     1-235                                            (printed 5/7/92)






     XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett((RR3e3eXfXf)e)erreennccee PPaaXXgmgmeCeCsrsreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett-The ArrowButtonGadget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//AArrrroowwBBGG..hh>>

          WWiiddggeett XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeAArrrroowwBBuuttttoonnGGaaddggeett creates an instance of an
          ArrowButtonGadget widget and returns the associated widget
          ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ArrowButtonGadget and its
          associated resources, see XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX)).
















     1-236                                            (printed 5/7/92)






     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd-The BulletinBoard widget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//BBuulllleettiinnBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeBBuulllleettiinnBBooaarrdd creates an instance of a BulletinBoard
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of BulletinBoard and its
          associated resources, see XXmmBBuulllleettiinnBBooaarrdd((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmBBuulllleettiinnBBooaarrdd((33XX)).

















     1-237                                            (printed 5/7/92)






     XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaallooRRgege(f(f3e3eXrXr)e)ennccee XXPmPmaCaCgrgreeeesasatteeBBuulllleettiinnBBooaarrddDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg-The BulletinBoard
          BulletinBoardDialog convenience creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//BBuulllleettiinnBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeBBuulllleettiinnBBooaarrddDDiiaalloogg is a convenience creation
          function that creates a DialogShell and an unmanaged
          BulletinBoard child of the DialogShell.  A
          BulletinBoardDialog is used for interactions not supported
          by the standard dialog set.  This function does not
          automatically create any labels, buttons, or other dialog
          components.  Such components should be added by the
          application after the BulletinBoardDialog is created.

          Use XXttMMaannaaggeeCChhiilldd to pop up the BulletinBoardDialog (passing
          the BulletinBoard as the widget parameter); use
          XXttUUnnmmaannaaggeeCChhiilldd to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of BulletinBoard and its
          associated resources, see XXmmBBuulllleettiinnBBooaarrdd((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmBBuulllleettiinnBBooaarrdd((33XX)).







     1-238                                            (printed 5/7/92)






     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn-The CascadeButton widget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCaassccaaddeeBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonn creates an instance of a CascadeButton
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID.  The parent must be a
                 RowColumn widget.

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of CascadeButton and its
          associated resources, see XXmmCCaassccaaddeeBBuuttttoonn((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCaassccaaddeeBBuuttttoonn((33XX)).
















     1-239                                            (printed 5/7/92)






     XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeeRRtete(f(f3e3eXrXr)e)ennccee XXPmPmaCaCgrgreeeesasatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett-The CascadeButtonGadget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCaassccaaddeeBBGG..hh>>

          WWiiddggeett XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeCCaassccaaddeeBBuuttttoonnGGaaddggeett creates an instance of a
          CascadeButtonGadget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID.  The parent must be a
                 RowColumn widget.

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of CascadeButtonGadget and its
          associated resources, see 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)).

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

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
















     1-240                                            (printed 5/7/92)






     XXmmCCrreeaatteeCCoommmmaanndd((33XX))      RReeffeerreennccee PPaaggeess      XXmmCCrreeaatteeCCoommmmaanndd((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeCCoommmmaanndd-The Command widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//CCoommmmaanndd..hh>>

          WWiiddggeett XXmmCCrreeaatteeCCoommmmaanndd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeCCoommmmaanndd creates an instance of a Command widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Command and its associated
          resources, see XXmmCCoommmmaanndd((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCoommmmaanndd((33XX)).


















     1-241                                            (printed 5/7/92)






     XXmmCCrreeaatteeDDiiaallooggS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mCCrreeaatteeDDiiaallooggSShheellll((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeDDiiaallooggSShheellll-The DialogShell widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//DDiiaallooggSS..hh>>

          WWiiddggeett XXmmCCrreeaatteeDDiiaallooggSShheellll ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeDDiiaallooggSShheellll creates an instance of a DialogShell
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of DialogShell and its associated
          resources, see XXmmDDiiaallooggSShheellll((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmDDiiaallooggSShheellll((33XX)).


















     1-242                                            (printed 5/7/92)






     XXmmCCrreeaatteeDDrraaggIIccoonn((33XX))     RReeffeerreennccee PPaaggeess     XXmmCCrreeaatteeDDrraaggIIccoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeDDrraaggIIccoonn-A Drag and Drop function that creates a
          DragIcon widget

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//DDrraaggIIccoonn..hh>>

          WWiiddggeett XXmmCCrreeaatteeDDrraaggIIccoonn ((_w_i_d_g_e_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett      _w_i_d_g_e_t;;
               SSttrriinngg      _n_a_m_e;;
               AArrggLLiisstt     _a_r_g_l_i_s_t;;
               CCaarrddiinnaall    _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeDDrraaggIIccoonn creates a DragIcon and returns the
          associated widget ID.


          _w_i_d_g_e_t Specifies the ID of the widget that the function uses
                 to access default values for visual attributes of the
                 DragIcon.  This widget may be different than the
                 actual parent of the DragIcon.

          _n_a_m_e   Specifies the name of the DragIcon widget.

          _a_r_g_l_i_s_tSpecifies the argument list.

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t).


          For a complete definition of DragIcon and its associated
          resources, see XXmmDDrraaggIIccoonn((33XX)).

     RREETTUURRNN VVAALLUUEE
          The function creates a DragIcon and returns the associated
          widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmDDrraaggCCoonntteexxtt((33XX)), XXmmDDrraaggIIccoonn((33XX)), and XXmmSSccrreeeenn((33XX)).













     1-243                                            (printed 5/7/92)






     XXmmCCrreeaatteeDDrraawwiinnggAArreeaa((33XX))  RReeffeerreennccee PPaaggeess  XXmmCCrreeaatteeDDrraawwiinnggAArreeaa((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeDDrraawwiinnggAArreeaa-The DrawingArea widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//DDrraawwiinnggAA..hh>>

          WWiiddggeett XXmmCCrreeaatteeDDrraawwiinnggAArreeaa ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeDDrraawwiinnggAArreeaa creates an instance of a DrawingArea
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of DrawingArea and its associated
          resources, see XXmmDDrraawwiinnggAArreeaa((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmDDrraawwiinnggAArreeaa((33XX)).


















     1-244                                            (printed 5/7/92)






     XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn((33XX))  RReeffeerreennccee PPaaggeess  XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn-The DrawnButton widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//DDrraawwnnBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeDDrraawwnnBBuuttttoonn creates an instance of a DrawnButton
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of DrawnButton and its associated
          resources, see XXmmDDrraawwnnBBuuttttoonn((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmDDrraawwnnBBuuttttoonn((33XX)).


















     1-245                                            (printed 5/7/92)






     XXmmCCrreeaatteeEErrrroorrDDiiaalloogg((33XX))  RReeffeerreennccee PPaaggeess  XXmmCCrreeaatteeEErrrroorrDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeEErrrroorrDDiiaalloogg-The MessageBox ErrorDialog convenience
          creation function

     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mCCrreeaatteeEErrrroorrDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeEErrrroorrDDiiaalloogg is a convenience creation function that
          creates a DialogShell and an unmanaged MessageBox child of
          the DialogShell.  An ErrorDialog warns the user of an
          invalid or potentially dangerous condition.  It includes a
          symbol, a message, and three buttons.  The default symbol is
          an octagon with a diagonal slash.  The default button labels
          are OOKK, CCaanncceell, and HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the ErrorDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).








     1-246                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx((33RRXeXe)f)feerreennccee PPaaggXXememsCsCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx-The FileSelectionBox widget
          creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//FFiilleeSSBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx creates an unmanaged
          FileSelectionBox.  A FileSelectionBox is used to select a
          file and includes the following:


            +o  An editable text field for the directory mask

            +o  A scrolling list of file names

            +o  An editable text field for the selected file

            +o  Labels for the list and text fields

            +o  Four buttons


          The default button labels are OOKK, FFiilltteerr, CCaanncceell, and HHeellpp.
          Additional work area children may be added to the
          FileSelectionBox after creation.  FileSelectionBox inherits
          the layout functionality provided by SelectionBox for any
          additional work area children.

          If the parent of the FileSelectionBox is a DialogShell, use
          XXttMMaannaaggeeCChhiilldd to pop up the FileSelectionDialog (passing the
          FileSelectionBox as the widget parameter); use
          XXttUUnnmmaannaaggeeCChhiilldd to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)



     1-247                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx((33RRXeXe)f)feerreennccee PPaaggXXememsCsCrreeaatteeFFiilleeSSeelleeccttiioonnBBooxx((33XX))



          For a complete definition of FileSelectionBox and its
          associated resources, see XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).















































     1-248                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaallooRRgege(f(f3e3eXrXr)e)ennccee XXPmPmaCaCgrgreeeesasatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg-The FileSelectionBox
          FileSelectionDialog convenience creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//FFiilleeSSBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg is a convenience creation
          function that creates a DialogShell and an unmanaged
          FileSelectionBox child of the DialogShell.  A
          FileSelectionDialog selects a file.  It includes the
          following:


            +o  An editable text field for the directory mask

            +o  A scrolling list of filenames

            +o  An editable text field for the selected file

            +o  Labels for the list and text fields

            +o  Four buttons


          The default button labels are:  OOKK, FFiilltteerr, CCaanncceell, and
          HHeellpp.  One additional WWoorrkkAArreeaa child may be added to the
          FileSelectionBox after creation.

          Use XXttMMaannaaggeeCChhiilldd to pop up the FileSelectionDialog (passing
          the FileSelectionBox as the widget parameter); use
          XXttUUnnmmaannaaggeeCChhiilldd to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)




     1-249                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFiilleeSSeelleeccttiioonnDDiiaallooRRgege(f(f3e3eXrXr)e)ennccee XXPmPmaCaCgrgreeeesasatteeFFiilleeSSeelleeccttiioonnDDiiaalloogg((33XX))



          For a complete definition of FileSelectionBox and its
          associated resources, see XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).















































     1-250                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFoorrmm((33XX))         RReeffeerreennccee PPaaggeess         XXmmCCrreeaatteeFFoorrmm((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeFFoorrmm-The Form widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeFFoorrmm ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeFFoorrmm creates an instance of a Form widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Form and its associated
          resources, see XXmmFFoorrmm((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmFFoorrmm((33XX)).


















     1-251                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFoorrmmDDiiaalloogg((33XX))   RReeffeerreennccee PPaaggeess   XXmmCCrreeaatteeFFoorrmmDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeFFoorrmmDDiiaalloogg-A Form FormDialog convenience creation
          function

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

          WWiiddggeett XXmmCCrreeaatteeFFoorrmmDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeFFoorrmmDDiiaalloogg is a convenience creation function that
          creates a DialogShell and an unmanaged Form child of the
          DialogShell.  A FormDialog is used for interactions not
          supported by the standard dialog set.  This function does
          not automatically create any labels, buttons, or other
          dialog components.  Such components should be added by the
          application after the FormDialog is created.

          Use XXttMMaannaaggeeCChhiilldd to pop up the FormDialog (passing the Form
          as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to pop it
          down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Form and its associated
          resources, see XXmmFFoorrmm((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmFFoorrmm((33XX)).








     1-252                                            (printed 5/7/92)






     XXmmCCrreeaatteeFFrraammee((33XX))        RReeffeerreennccee PPaaggeess        XXmmCCrreeaatteeFFrraammee((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeFFrraammee-The Frame widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeFFrraammee ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeFFrraammee creates an instance of a Frame widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Frame and its associated
          resources, see XXmmFFrraammee((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmFFrraammee((33XX)).


















     1-253                                            (printed 5/7/92)






     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((RR3e3eXfXf)e)erreennccee PPaaXXgmgmeCeCsrs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))



     NNAAMMEE
          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-The MessageBox InformationDialog
          convenience creation function

     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mCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          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 is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell.  An InformationDialog gives the user
          information, such as the status of an action.  It includes a
          symbol, a message, and three buttons.  The default symbol is
          a lower case ii.  The default button labels are OOKK, CCaanncceell,
          and HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the InformationDialog (passing
          the MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd
          to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).








     1-254                                            (printed 5/7/92)






     XXmmCCrreeaatteeLLaabbeell((33XX))        RReeffeerreennccee PPaaggeess        XXmmCCrreeaatteeLLaabbeell((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeLLaabbeell-The Label widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeLLaabbeell ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeLLaabbeell creates an instance of a Label widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Label and its associated
          resources, see XXmmLLaabbeell((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLaabbeell((33XX)).


















     1-255                                            (printed 5/7/92)






     XXmmCCrreeaatteeL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mCCrreeaatteeLLaabbeellGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeLLaabbeellGGaaddggeett-The LabelGadget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//LLaabbeellGG..hh>>

          WWiiddggeett XXmmCCrreeaatteeLLaabbeellGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeLLaabbeellGGaaddggeett creates an instance of a LabelGadget
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of LabelGadget and its associated
          resources, see XXmmLLaabbeellGGaaddggeett((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLaabbeellGGaaddggeett((33XX)).


















     1-256                                            (printed 5/7/92)






     XXmmCCrreeaatteeLLiisstt((33XX))         RReeffeerreennccee PPaaggeess         XXmmCCrreeaatteeLLiisstt((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeLLiisstt-The List widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeLLiisstt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeLLiisstt creates an instance of a List widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of List and its associated
          resources, see XXmmLLiisstt((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLiisstt((33XX)).


















     1-257                                            (printed 5/7/92)






     XXmmCCrreeaatteeM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mCCrreeaatteeMMaaiinnWWiinnddooww((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeMMaaiinnWWiinnddooww-The MainWindow widget creation function

     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mCCrreeaatteeMMaaiinnWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeMMaaiinnWWiinnddooww creates an instance of a MainWindow
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MainWindow widget ID.

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


















     1-258                                            (printed 5/7/92)






     XXmmCCrreeaatteeMMeennuuBBaarr((33XX))      RReeffeerreennccee PPaaggeess      XXmmCCrreeaatteeMMeennuuBBaarr((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeMMeennuuBBaarr-A RowColumn widget convenience creation
          function

     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mCCrreeaatteeMMeennuuBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeMMeennuuBBaarr creates an instance of a RowColumn widget of
          type XXmmMMEENNUU__BBAARR and returns the associated widget ID.It is
          provided as a convenience function for creating RowColumn
          widgets configured to operate as a MenuBar and is not
          implemented as a separate widget class.

          The MenuBar widget is generally used for building a Pulldown
          menu system.  Typically, a MenuBar is created and placed
          along the top of the application window, and several
          CascadeButtons are inserted as the children.  Each of the
          CascadeButtons has a Pulldown MenuPane associated with it.
          These Pulldown MenuPanes must have been created as children
          of the MenuBar.  The user interacts with the MenuBar by
          using either the mouse or the keyboard.

          The MenuBar displays a 3-D shadow along its border.  The
          application controls the shadow attributes using the
          visual-related resources supported by XXmmMMaannaaggeerr.

          The MenuBar widget is  homogeneous in that it accepts only
          children that are a subclass of XXmmCCaassccaaddeeBBuuttttoonn or
          XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett.  Attempting to insert a child of a
          different class results in a warning message.

          If the MenuBar does not have enough room to fit all of its
          subwidgets on a single line, the MenuBar attempts to wrap
          the remaining entries onto additional lines if allowed by
          the geometry manager of the parent widget.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t



     1-259                                            (printed 5/7/92)






     XXmmCCrreeaatteeMMeennuuBBaarr((33XX))      RReeffeerreennccee PPaaggeess      XXmmCCrreeaatteeMMeennuuBBaarr((33XX))



                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 RowColumn widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCaassccaaddeeBBuuttttoonn((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mCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)),
          XXmmMMaannaaggeerr((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)).








































     1-260                                            (printed 5/7/92)






     XXmmCCrreeaatteeM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mCCrreeaatteeMMeennuuSShheellll((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeMMeennuuSShheellll-The MenuShell widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeMMeennuuSShheellll ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeMMeennuuSShheellll creates an instance of a MenuShell widget
          and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of MenuShell and its associated
          resources, see XXmmMMeennuuSShheellll((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeennuuSShheellll((33XX)).


















     1-261                                            (printed 5/7/92)






     XXmmCCrreeaatteeM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mCCrreeaatteeMMeessssaaggeeBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeMMeessssaaggeeBBooxx-The MessageBox widget creation function

     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mCCrreeaatteeMMeessssaaggeeBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeMMeessssaaggeeBBooxx creates an unmanaged MessageBox.  A
          MessageBox is used for common interaction tasks, which
          include giving information, asking questions, and reporting
          errors.  It includes an optional symbol, a message, and
          three buttons.

          By default, there is no symbol.  The default button labels
          are OOKK, CCaanncceell, and HHeellpp.

          If the parent of the MessageBox is a DialogShell, use
          XXttMMaannaaggeeCChhiilldd to pop up the MessageBox (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).







     1-262                                            (printed 5/7/92)






     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))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg-The MessageBox MessageDialog
          convenience creation function

     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mCCrreeaatteeMMeessssaaggeeDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell.  A MessageDialog is used for common
          interaction tasks, which include giving information, asking
          questions, and reporting errors.  It includes a symbol, a
          message, and three buttons.  By default, there is no symbol.
          The default button labels are OOKK, CCaanncceell, and HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the MessageDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).








     1-263                                            (printed 5/7/92)






     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))   RReeffeerreennccee PPaaggeess   XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeOOppttiioonnMMeennuu-A RowColumn widget convenience creation
          function

     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mCCrreeaatteeOOppttiioonnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeOOppttiioonnMMeennuu creates an instance of a RowColumn widget
          of type XXmmMMEENNUU__OOPPTTIIOONN and returns the associated widget ID.

          It is provided as a convenience function for creating a
          RowColumn widget configured to operate as an OptionMenu and
          is not implemented as a separate widget class.

          The OptionMenu widget is a specialized RowColumn manager
          composed of a label, a selection area, and a single Pulldown
          MenuPane.  When an application creates an OptionMenu widget,
          it supplies the label string and the Pulldown MenuPane.  In
          order to succeed, there must be a valid XXmmNNssuubbMMeennuuIIdd
          resource set when calling this function.  When the
          OptionMenu is created, the Pulldown MenuPane must have been
          created as a child of the OptionMenu's parent and must be
          specified.  The LabelGadget and the selection area (a
          CascadeButtonGadget) are created by the OptionMenu.

          The OptionMenu's Pulldown MenuPane must not contain any
          ToggleButtons or ToggleButtonGadgets.  The results of
          including CascadeButtons or CascadeButtonGadgets in the
          OptionMenu's Pulldown MenuPane are undefined.

          An OptionMenu is laid out with the label displayed on one
          side of the widget and the selection area on the other side
          when XXmmNNoorriieennttaattiioonn is XmHORIZONTAL.  If the value is
          XmVERTICAL, the label is above the selection area. The
          selection area has a dual purpose; it displays the label of
          the last item selected from the associated Pulldown
          MenuPane, and it provides the means for posting the Pulldown
          MenuPane.

          The OptionMenu typically does not display any 3-D visuals
          around itself or the internal LabelGadget.  By default, the
          internal CascadeButtonGadget has a visible 3-D shadow.  The
          application may change this by getting the
          CascadeButtonGadget ID using XXmmOOppttiioonnBBuuttttoonnGGaaddggeett, and then



     1-264                                            (printed 5/7/92)






     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))   RReeffeerreennccee PPaaggeess   XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))



          calling XXttSSeettVVaalluueess using the standard visual-related
          resources.

          The Pulldown MenuPane is posted by moving the mouse pointer
          over the selection area and pressing a mouse button defined
          by OptionMenu's RowColumn parent.  The Pulldown MenuPane is
          posted and positioned so that the last selected item is
          directly over the selection area.  The mouse is then used to
          arm the desired menu item.  When the mouse button is
          released, the armed menu item is selected and the label
          within the selection area is changed to match that of the
          selected item.  By default, BBSSeelleecctt is used to interact with
          an OptionMenu.  The default can be changed via the RowColumn
          resource XXmmNNmmeennuuPPoosstt.

          The OptionMenu also operates by using the keyboard interface
          mechanism.  If the application has established a mnemonic
          with the OptionMenu, typing Alt with the mnemonic causes the
          Pulldown MenuPane to be posted with traversal enabled.  The
          standard traversal keys can then be used to move within the
          MenuPane.  Selection can occur as the result of pressing the
          Return key or typing a mnemonic or accelerator for one of
          the menu items.

          An application may use the XXmmNNmmeennuuHHiissttoorryy resource to
          indicate which item in the Pulldown MenuPane should be
          treated as the current choice and have its label displayed
          in the selection area.  By default, the first item in the
          Pulldown MenuPane is used.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          The user can specify resources in a resource file for the
          automatically created widgets and gadgets of an OptionMenu.
          The following list identifies the names of these widgets (or
          gadgets) and the associated OptionMenu areas.


            +o

            +o  Option Menu Label Gadget-"OptionLabel"




     1-265                                            (printed 5/7/92)






     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))   RReeffeerreennccee PPaaggeess   XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX))



            +o  Option Menu Cascade Button-"OptionButton"


          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 RowColumn widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          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mCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)),
          XXmmCCrreeaatteeSSiimmpplle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)), XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)).









































     1-266                                            (printed 5/7/92)






     XXmmCCrreeaatteePPaanneeddW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mCCrreeaatteePPaanneeddWWiinnddooww((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPaanneeddWWiinnddooww-The PanedWindow widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//PPaanneeddWW..hh>>

          WWiiddggeett XXmmCCrreeaatteePPaanneeddWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPaanneeddWWiinnddooww creates an instance of a PanedWindow
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of PanedWindow and its associated
          resources, see XXmmPPaanneeddWWiinnddooww((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmPPaanneeddWWiinnddooww((33XX)).


















     1-267                                            (printed 5/7/92)






     XXmmCCrreeaatteePPooppuuppMMeennuu((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteePPooppuuppMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPooppuuppMMeennuu-A RowColumn widget convenience creation
          function

     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mCCrreeaatteePPooppuuppMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPooppuuppMMeennuu creates an instance of a RowColumn widget
          of type XXmmMMEENNUU__PPOOPPUUPP and returns the associated widget ID.
          When using this function to create the Popup MenuPane, a
          MenuShell widget is automatically created as the parent of
          the MenuPane.  The parent of the MenuShell widget is the
          widget indicated by the _p_a_r_e_n_t parameter.

          XXmmCCrreeaatteePPooppuuppMMeennuu is provided as a convenience function for
          creating RowColumn widgets configured to operate as Popup
          MenuPanes and is not implemented as a separate widget class.

          The PopupMenu is used as the first MenuPane within a
          PopupMenu system; all other MenuPanes are of the Pulldown
          type.  A Popup MenuPane displays a 3-D shadow, unless the
          feature is disabled by the application.  The shadow appears
          around the edge of the MenuPane.

          The Popup MenuPane must be created as the child of a
          MenuShell widget in order to function properly when it is
          incorporated into a menu.  If the application uses this
          convenience function for creating a Popup MenuPane, the
          MenuShell is automatically created as the real parent of the
          MenuPane.  If the application does not use this convenience
          function to create the RowColumn to function as a Popup
          MenuPane, it is the application's responsibility to create
          the MenuShell widget.

          To access the PopupMenu, the application must first position
          the widget using the XXmmMMeennuuPPoossiittiioonn function and then manage
          it using XXttMMaannaaggeeCChhiilldd.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list



     1-268                                            (printed 5/7/92)






     XXmmCCrreeaatteePPooppuuppMMeennuu((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteePPooppuuppMMeennuu((33XX))



          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          Popup MenuPanes support tear-off capabilities for tear-off
          menus through XXmmRRoowwCCoolluummnn resources.  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 RowColumn widget ID.

     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eSSiimmpplleePPooppuuppMMeennuu((33XX)), XXmmMMeennuuPPoossiittiioonn((33XX)),
          XXmmMMeennuuSShheellll((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)).






































     1-269                                            (printed 5/7/92)






     XXmmCCrreeaatteePPrroommppttDDiiaalloogg((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteePPrroommppttDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPrroommppttDDiiaalloogg-The SelectionBox PromptDialog
          convenience creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>

          WWiiddggeett XXmmCCrreeaatteePPrroommppttDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPrroommppttDDiiaalloogg is a convenience creation function that
          creates a DialogShell and an unmanaged SelectionBox child of
          the DialogShell.  A PromptDialog prompts the user for text
          input.  It includes a message, a text input region, and
          three managed buttons.  The default button labels are OOKK,
          CCaanncceell, and HHeellpp.  An additional button, with AAppppllyy as the
          default label, is created unmanaged; it may be explicitly
          managed if needed.  One additional WWoorrkkAArreeaa child may be
          added to the SelectionBox after creation.

          XXmmCCrreeaatteePPrroommppttDDiiaalloogg forces the value of the SelectionBox
          resource XXmmNNddiiaallooggTTyyppee to XXmmDDIIAALLOOGG__PPRROOMMPPTT.

          Use XXttMMaannaaggeeCChhiilldd to pop up the PromptDialog (passing the
          SelectionBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd
          to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of SelectionBox and its associated
          resources, see XXmmSSeelleeccttiioonnBBooxx((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSeelleeccttiioonnBBooxx((33XX)).



     1-270                                            (printed 5/7/92)






     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPuullllddoowwnnMMeennuu-A RowColumn widget convenience creation
          function

     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mCCrreeaatteePPuullllddoowwnnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPuullllddoowwnnMMeennuu creates an instance of a RowColumn
          widget of type XXmmMMEENNUU__PPUULLLLDDOOWWNN and returns the associated
          widget ID.  When using this function to create the Pulldown
          MenuPane, a MenuShell widget is automatically created as the
          parent of the MenuPane. If the widget specified by the
          _p_a_r_e_n_t parameter is a Popup or a Pulldown MenuPane, the
          MenuShell widget is created as a child of the _p_a_r_e_n_t's
          MenuShell; otherwise, it is created as a child of the
          specified _p_a_r_e_n_t widget.

          XXmmCCrreeaatteePPuullllddoowwnnMMeennuu is provided as a convenience function
          for creating RowColumn widgets configured to operate as
          Pulldown MenuPanes and is not implemented as a separate
          widget class.

          A Pulldown MenuPane displays a 3-D shadow, unless the
          feature is disabled by the application.  The shadow appears
          around the edge of the MenuPane.

          A Pulldown MenuPane is used when creating submenus that are
          to be attached to a CascadeButton or a CascadeButtonGadget.
          This is the case for all MenuPanes that are part of a
          PulldownMenu system (a MenuBar), the MenuPane associated
          with an OptionMenu, and any MenuPanes that cascade from a
          Popup MenuPane.  Pulldown MenuPanes that are to be
          associated with an OptionMenu must be created before the
          OptionMenu is created.

          The Pulldown MenuPane must be attached to a CascadeButton or
          CascadeButtonGadget that resides in a MenuBar, a Popup
          MenuPane, a Pulldown MenuPane, or an OptionMenu.  This is
          done by using the button resource XXmmNNssuubbMMeennuuIIdd.

          A MenuShell widget is required between the Pulldown MenuPane
          and its parent.  If the application uses this convenience
          function for creating a Pulldown MenuPane, the MenuShell is
          automatically created as the real parent of the MenuPane;



     1-271                                            (printed 5/7/92)






     XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteePPuullllddoowwnnMMeennuu((33XX))



          otherwise, it is the application's responsibility to create
          the MenuShell widget.

          To function correctly when incorporated into a menu, the
          Pulldown MenuPane's hierarchy must be considered; this
          hierarchy depends on the type of menu system that is being
          built as follows:


            +o  If the Pulldown MenuPane is to be pulled down from a
               MenuBar, its _p_a_r_e_n_t must be the MenuBar.

            +o  If the Pulldown MenuPane is to be pulled down from a
               Popup or another Pulldown MenuPane, its _p_a_r_e_n_t must be
               that Popup or Pulldown MenuPane.

            +o  If the Pulldown MenuPane is to be pulled down from an
               OptionMenu, its _p_a_r_e_n_t must be the same as the
               OptionMenu parent.

            +o  Specifies the parent widget ID

            +o  Specifies the name of the created widget

            +o  Specifies the argument list

            +o  Specifies the number of attribute/value pairs in the
               argument list (_a_r_g_l_i_s_t)


          PullDown MenuPanes support tear-off capabilities for tear-
          off menus through XXmmRRoowwCCoolluummnn resources.  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 RowColumn widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCaassccaaddeeBBuuttttoonn((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mCCrreeaatteeOOppttiioonnMMeennuu((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eSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), XXmmMMeennuuSShheellll((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)).












     1-272                                            (printed 5/7/92)






     XXmmCCrreeaatteePPuusshhBBuuttttoonn((33XX))   RReeffeerreennccee PPaaggeess   XXmmCCrreeaatteePPuusshhBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPuusshhBBuuttttoonn-The PushButton widget creation function

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

          WWiiddggeett XXmmCCrreeaatteePPuusshhBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPuusshhBBuuttttoonn creates an instance of a PushButton
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of PushButton and its associated
          resources, see XXmmPPuusshhBBuuttttoonn((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmPPuusshhBBuuttttoonn((33XX)).


















     1-273                                            (printed 5/7/92)






     XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett((33RRXeXe)f)feerreennccee PPaaggXXememsCsCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett-The PushButtonGadget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//PPuusshhBBGG..hh>>

          WWiiddggeett XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteePPuusshhBBuuttttoonnGGaaddggeett creates an instance of a
          PushButtonGadget widget and returns the associated widget
          ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of PushButtonGadget and its
          associated resources, see XXmmPPuusshhBBuuttttoonnGGaaddggeett((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmPPuusshhBBuuttttoonnGGaaddggeett((33XX)).
















     1-274                                            (printed 5/7/92)






     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))RReeffeerreennccee PPaaggeess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))



     NNAAMMEE
          XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg-The MessageBox QuestionDialog
          convenience creation function

     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mCCrreeaatteeQQuueessttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell.  A QuestionDialog is used to get the
          answer to a question from the user.  It includes a symbol, a
          message, and three buttons.   The default symbol is a
          question mark.  The default button labels are OOKK, CCaanncceell,
          and HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the QuestionDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).








     1-275                                            (printed 5/7/92)






     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX))     RReeffeerreennccee PPaaggeess     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeRRaaddiiooBBooxx-A RowColumn widget convenience creation
          function

     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mCCrreeaatteeRRaaddiiooBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeRRaaddiiooBBooxx creates an instance of a RowColumn widget
          of type XXmmWWOORRKK__AARREEAA and returns the associated widget ID.
          Typically, this is a composite widget that contains multiple
          ToggleButtonGadgets.  The RadioBox arbitrates and ensures
          that at most one ToggleButtonGadget is on at any time.

          Unless the application supplies other values in the _a_r_g_l_i_s_t,
          this function provides initial values for several RowColumn
          resources.  It initializes XXmmNNppaacckkiinngg to XXmmPPAACCKK__CCOOLLUUMMNN,
          XXmmNNrraaddiiooBBeehhaavviioorr to True, XXmmNNiissHHoommooggeenneeoouuss to True, and
          XXmmNNeennttrryyCCllaassss to xxmmTToogggglleeBBuuttttoonnGGaaddggeettCCllaassss.

          In a RadioBox the ToggleButton or ToggleButtonGadget
          resource XXmmNNiinnddiiccaattoorrTTyyppee defaults to XXmmOONNEE__OOFF__MMAANNYY, and the
          ToggleButton or ToggleButtonGadget resourceXXmmNNvviissiibblleeWWhheennOOffff
          defaults to True.

          This routine is provided as a convenience function for
          creating RowColumn widgets.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 RowColumn widget ID.



     1-276                                            (printed 5/7/92)






     XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX))     RReeffeerreennccee PPaaggeess     XXmmCCrreeaatteeRRaaddiiooB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
          XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).


















































     1-277                                            (printed 5/7/92)






     XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeRRoowwCCoolluummnn-The RowColumn widget creation function

     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mCCrreeaatteeRRoowwCCoolluummnn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeRRoowwCCoolluummnn creates an instance of a RowColumn widget
          and returns the associated widget ID.  If XXmmNNrroowwCCoolluummnnTTyyppee
          is not specified, then it is created with XXmmWWOORRKK__AARREEAA, which
          is the default.

          If this function is used to create a Popup Menu of type
          XXmmMMEENNUU__PPOOPPUUPP or a Pulldown Menu of type XXmmMMEENNUU__PPUULLLLDDOOWWNN, a
          MenuShell widget is not automatically created as the parent
          of the MenuPane.  The application must first create the
          MenuShell by using either XXmmCCrreeaatteeMMeennuuSShheellll or the standard
          toolkit create function.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 RowColumn widget ID.

     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eMMeennuuBBaarr((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eOOppttiioonnMMeennuu((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nMMeennuu((33XX)), XXmmCCrreeaatteeRRaaddiiooBBooxx((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)),
          XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)),
          XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)), XXmmRRoowwCCoolluummnn((33XX)),



     1-278                                            (printed 5/7/92)






     XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX))



          XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)),
          XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)),
          XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)),
          XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).


















































     1-279                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccaallee((33XX))        RReeffeerreennccee PPaaggeess        XXmmCCrreeaatteeSSccaallee((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSccaallee-The Scale widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeSSccaallee ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSccaallee creates an instance of a Scale widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Scale and its associated
          resources, see XXmmSSccaallee((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSccaallee((33XX)).


















     1-280                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroollllBBaarr((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteeSSccrroollllBBaarr((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSccrroollllBBaarr-The ScrollBar widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSccrroollllBBaarr..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSccrroollllBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSccrroollllBBaarr creates an instance of a ScrollBar widget
          and returns the associated widget ID.

          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ScrollBar and its associated
          resources, see XXmmSSccrroollllBBaarr((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSccrroollllBBaarr((33XX)).



















     1-281                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroolllleeddLLiisstt((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSccrroolllleeddLLiisstt((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSccrroolllleeddLLiisstt-The List ScrolledList convenience
          creation function

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

          WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddLLiisstt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSccrroolllleeddLLiisstt creates an instance of a List widget
          that is contained within a ScrolledWindow.  All
          ScrolledWindow subarea widgets are automatically created by
          this function. The ID returned by this function is that of
          the List widget.  Use this ID for all normal List
          operations, as well as those that are relevant for the
          ScrolledList widget.

          All arguments to either the List or the ScrolledWindow
          widget can be specified at creation time using this
          function.  Changes to initial position and size are sent
          only to the ScrolledWindow widget.  Other resources are sent
          to the List or the ScrolledWindow widget as appropriate.

          This function forces the following initial values for
          ScrolledWindow resources:


            +o  XXmmNNssccrroolllliinnggPPoolliiccyy is set to XXmmAAPPPPLLIICCAATTIIOONN__DDEEFFIINNEEDD.

            +o  XXmmNNvviissuuaallPPoolliiccyy is set to XXmmVVAARRIIAABBLLEE.

            +o  XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy is set to XXmmSSTTAATTIICC.  (No
               initial value is forced for the List's
               XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy.)

            +o  XXmmNNsshhaaddoowwTThhiicckknneessss is set to 0.


          To obtain the ID of the ScrolledWindow widget associated
          with the ScrolledList, use the Xt Intrinsics XXttPPaarreenntt
          function.  The name of the ScrolledWindow created by this
          function is formed by concatenating the letters SSWW onto the
          end of the _n_a_m_e specified in the parameter list.


          _p_a_r_e_n_t Specifies the parent widget ID



     1-282                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroolllleeddLLiisstt((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSccrroolllleeddLLiisstt((33XX))



          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of List and its associated
          resources, see XXmmLLiisstt((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLiisstt((33XX)) and XXmmSSccrroolllleeddWWiinnddooww((33XX)).






































     1-283                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt-The TextScrolledText convenience
          creation function

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

          WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt creates an instance of a Text widget
          that is contained within a ScrolledWindow.  All
          ScrolledWindow subarea widgets are automatically created by
          this function. The ID returned by this function is that of
          the Text widget.  Use this ID for all normal Text
          operations, as well as those that are relevant for the
          ScrolledText widget.

          The Text widget defaults to single-line text edit;
          therefore, no ScrollBars are displayed.  The Text resource
          XXmmNNeeddiittMMooddee must be set to XXmmMMUULLTTII__LLIINNEE__EEDDIITT to display the
          ScrollBars.  The results of placing a Text widget inside a
          ScrolledWindow when the Text's XXmmNNeeddiittMMooddee is
          XXmmSSIINNGGLLEE__LLIINNEE__EEDDIITT are undefined.

          All arguments to either the Text or the ScrolledWindow
          widget can be specified at creation time using this
          function.  Changes to initial position and size are sent
          only to the ScrolledWindow widget.  Other resources are sent
          to the Text or the ScrolledWindow widget as appropriate.

          This function forces the following initial values for
          ScrolledWindow resources:


            +o  XXmmNNssccrroolllliinnggPPoolliiccyy is set to XXmmAAPPPPLLIICCAATTIIOONN__DDEEFFIINNEEDD.

            +o  XXmmNNvviissuuaallPPoolliiccyy is set to XXmmVVAARRIIAABBLLEE.

            +o  XXmmNNssccrroollllBBaarrDDiissppllaayyPPoolliiccyy is set to XXmmSSTTAATTIICC.

            +o  XXmmNNsshhaaddoowwTThhiicckknneessss is set to 0.


          To obtain the ID of the ScrolledWindow widget associated
          with the ScrolledText, use the Xt Intrinsics XXttPPaarreenntt
          function.  The name of the ScrolledWindow created by this



     1-284                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSccrroolllleeddTTeexxtt((33XX))



          function is formed by concatenating the letters SSWW onto the
          end of the _n_a_m_e specified in the parameter list.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Text and its associated
          resources, see XXmmTTeexxtt((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSccrroolllleeddWWiinnddooww((33XX)) and XXmmTTeexxtt((33XX)).
































     1-285                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSccrroolllleeddW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mCCrreeaatteeSSccrroolllleeddWWiinnddooww((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww-The ScrolledWindow widget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSccrroolllleeddWW..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSccrroolllleeddWWiinnddooww creates an instance of a
          ScrolledWindow widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ScrolledWindow and its
          associated resources, see XXmmSSccrroolllleeddWWiinnddooww((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSccrroolllleeddWWiinnddooww((33XX)).

















     1-286                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx-The SelectionBox widget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx creates an unmanaged SelectionBox.  A
          SelectionBox is used to get a selection from a list of
          alternatives from the user and includes the following:


            +o  A scrolling list of alternatives

            +o  An editable text field for the selected alternative

            +o  Labels for the list and text field

            +o  Three or four buttons


          The default button labels are OOKK, CCaanncceell, and HHeellpp.  By
          default an AAppppllyy button is also created; if the parent of
          the SelectionBox is a DialogShell it is managed, and
          otherwise it is unmanaged.  Additional work area children
          may be added to the SelectionBox after creation.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of SelectionBox and its associated
          resources, see XXmmSSeelleeccttiioonnBBooxx((33XX)).

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



     1-287                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeelleeccttiioonnBBooxx((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeSSeelleeccttiioonnB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
          XXmmSSeelleeccttiioonnBBooxx((33XX)).





















































     1-288                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg((33XXRR)e)effeerreennccee PPaaggeeXXsmsmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg-The SelectionBox SelectionDialog
          convenience creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSeelleeccttiiooBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged SelectionBox
          child of the DialogShell.  A SelectionDialog offers the user
          a choice from a list of alternatives and gets a selection.
          It includes the following:


            +o  A scrolling list of alternatives

            +o  An editable text field for the selected alternative

            +o  Labels for the text field

            +o  Four buttons


          The default button labels are OOKK, CCaanncceell, AAppppllyy, and HHeellpp.
          One additional WWoorrkkAArreeaa child may be added to the
          SelectionBox after creation.

          XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg forces the value of the SelectionBox
          resource XXmmNNddiiaallooggTTyyppee to XXmmDDIIAALLOOGG__SSEELLEECCTTIIOONN.

          Use XXttMMaannaaggeeCChhiilldd to pop up the SelectionDialog (passing the
          SelectionBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd
          to pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)



     1-289                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg((33XXRR)e)effeerreennccee PPaaggeeXXsmsmCCrreeaatteeSSeelleeccttiioonnDDiiaalloogg((33XX))



          For a complete definition of SelectionBox and its associated
          resources, see XXmmSSeelleeccttiioonnBBooxx((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSeelleeccttiioonnBBooxx((33XX)).















































     1-290                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeeppaarraattoorr((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteeSSeeppaarraattoorr((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSeeppaarraattoorr-The Separator widget creation function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSeeppaarraattoorr..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSeeppaarraattoorr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSeeppaarraattoorr creates an instance of a Separator widget
          and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Separator and its associated
          resources, see XXmmSSeeppaarraattoorr((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSeeppaarraattoorr((33XX)).


















     1-291                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett((33XXRR)e)effeerreennccee PPaaggeeXXsmsmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett-The SeparatorGadget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//SSeeppaarraattooGG..hh>>

          WWiiddggeett XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSeeppaarraattoorrGGaaddggeett creates an instance of a
          SeparatorGadget widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of SeparatorGadget and its
          associated resources, see XXmmSSeeppaarraattoorrGGaaddggeett((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmSSeeppaarraattoorrGGaaddggeett((33XX)).

















     1-292                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleeCChheecckkBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx creates an instance of a RowColumn
          widget of type XXmmWWOORRKK__AARREEAA and returns the associated widget
          ID.

          This routine creates a CheckBox and its ToggleButtonGadget
          children.  A CheckBox is similar to a RadioBox, except that
          more than one button can be selected at a time.  The name of
          each button is button__n, where _n is an integer from 0 to one
          minus the number of buttons in the menu.  Buttons are named
          and created in the order in which they are specified in the
          RowColumn simple menu creation resources supplied in the
          argument list.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          type allowed in the XXmmNNbbuuttttoonnTTyyppee resource is XXmmCCHHEECCKKBBUUTTTTOONN.
          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 RowColumn widget ID.

     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eRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmRRoowwCCoolluummnn((33XX)),



     1-293                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX))



          XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).





















































     1-294                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleeMMeennuuBBaarr ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleeMMeennuuBBaarr creates an instance of a RowColumn
          widget of type XXmmMMEENNUU__BBAARR and returns the associated widget
          ID.

          This routine creates a MenuBar and its CascadeButtonGadget
          children.  The name of each button is button__n, where _n is
          an integer from 0 to one minus the number of buttons in the
          menu.  Buttons are named and created in the order in which
          they are specified in the RowColumn simple menu creation
          resources supplied in the argument list.

          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          type allowed in the XXmmNNbbuuttttoonnTTyyppee resource is
          XXmmCCAASSCCAADDEEBBUUTTTTOONN.  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 RowColumn widget ID.

     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eMMeennuuBBaarr((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)), XXmmRRoowwCCoolluummnn((33XX)),
          and XXmmVVaaCCrreeaatteeSSiimmpplleeMMeennuuBBaarr((33XX)).






     1-295                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33RRXeXe)f)feerreennccee PPaaggXXememsCsCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu creates an instance of a RowColumn
          widget of type XXmmMMEENNUU__OOPPTTIIOONN and returns the associated
          widget ID.

          This routine creates an Option Menu and its submenu
          containing PushButtonGadget or CascadeButtonGadget children.
          The name of each button is button__n, where _n is an integer
          from 0 to one minus the number of buttons in the menu.  The
          name of each separator is separator__n, where _n is an integer
          from 0 to one minus the number of separators in the menu.
          Buttons and separators are named and created in the order in
          which they are specified in the RowColumn simple menu
          creation resources supplied in the argument list.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          The user can specify resources in a resource file for the
          automatically created widgets and gadgets of an OptionMenu.
          The following list identifies the names of these widgets (or
          gadgets) and the associated OptionMenu areas.


            +o

            +o  Option Menu Label Gadget-"OptionLabel"

            +o  Option Menu Cascade Button-"OptionButton"



     1-296                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33RRXeXe)f)feerreennccee PPaaggXXememsCsCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX))



          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          types allowed in the XXmmNNbbuuttttoonnTTyyppee resource are
          XXmmPPUUSSHHBBUUTTTTOONN, XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmSSEEPPAARRAATTOORR, and
          XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  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 RowColumn widget ID.

     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CrreeaatteeRRoowwCCoolluummnn((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleeOOppttiioonnMMeennuu((33XX)).










































     1-297                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XXRR)e)effeerreennccee PPaaggeeXXsmsmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu creates an instance of a RowColumn
          widget of type XXmmMMEENNUU__PPOOPPUUPP and returns the associated
          widget ID.

          This routine creates a Popup MenuPane and its button
          children.  The name of each button is button__n, where _n is
          an integer from 0 to one minus the number of buttons in the
          menu.  The name of each separator is separator__n, where _n is
          an integer from 0 to one minus the number of separators in
          the menu.  The name of each title is label__n, where _n is an
          integer from 0 to one minus the number of titles in the
          menu.  Buttons, separators, and titles are named and created
          in the order in which they are specified in the RowColumn
          simple menu creation resources supplied in the argument
          list.


          _p_a_r_e_n_t Specifies the widget ID of the parent of the
                 MenuShell

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          types allowed in the XXmmNNbbuuttttoonnTTyyppee resource are
          XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmPPUUSSHHBBUUTTTTOONN, XXmmRRAADDIIOOBBUUTTTTOONN, XXmmCCHHEECCKKBBUUTTTTOONN,
          XXmmTTIITTLLEE, XXmmSSEEPPAARRAATTOORR, and XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  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)).




     1-298                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XXRR)e)effeerreennccee PPaaggeeXXsmsmCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX))



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

     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ePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPooppuuppMMeennuu((33XX)).

















































     1-299                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuuRR(e(e3f3fXeXe)r)reennccee PPXXamamgCgCererseseaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu creates an instance of a
          RowColumn widget of type XXmmMMEENNUU__PPUULLLLDDOOWWNN and returns the
          associated widget ID.

          This routine creates a Pulldown MenuPane and its button
          children.  The name of each button is button__n, where _n is
          an integer from 0 to one minus the number of buttons in the
          menu.  The name of each separator is separator__n, where _n is
          an integer from 0 to one minus the number of separators in
          the menu.  The name of each title is label__n, where _n is an
          integer from 0 to one minus the number of titles in the
          menu.  Buttons, separators, and titles are named and created
          in the order in which they are specified in the RowColumn
          simple menu creation resources supplied in the argument
          list.


          _p_a_r_e_n_t Specifies the widget ID of the parent of the
                 MenuShell

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          types allowed in the XXmmNNbbuuttttoonnTTyyppee resource are
          XXmmCCAASSCCAADDEEBBUUTTTTOONN, XXmmPPUUSSHHBBUUTTTTOONN, XXmmRRAADDIIOOBBUUTTTTOONN, XXmmCCHHEECCKKBBUUTTTTOONN,
          XXmmTTIITTLLEE, XXmmSSEEPPAARRAATTOORR, and XXmmDDOOUUBBLLEE__SSEEPPAARRAATTOORR.  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)).




     1-300                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuuRR(e(e3f3fXeXe)r)reennccee PPXXamamgCgCererseseaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX))



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

     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ePPuullllddoowwnnMMeennuu((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)),
          XXmmRRoowwCCoolluummnn((33XX)), and XXmmVVaaCCrreeaatteeSSiimmpplleePPuullllddoowwnnMMeennuu((33XX)).

















































     1-301                                            (printed 5/7/92)






     XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx-A RowColumn widget convenience
          creation function

     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mCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx creates an instance of a RowColumn
          widget of type XXmmWWOORRKK__AARREEAA and returns the associated widget
          ID.

          This routine creates a Radio Box and its ToggleButtonGadget
          children.  The name of each button is button__n, where _n is
          an integer from 0 to one minus the number of buttons in the
          menu.  Buttons are named and created in the order in which
          they are specified in the RowColumn simple menu creation
          resources supplied in the argument list.

          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          A number of resources exist specifically for use with this
          and other simple menu creation routines.  The only button
          type allowed in the XXmmNNbbuuttttoonnTTyyppee resource is XXmmRRAADDIIOOBBUUTTTTOONN.
          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 RowColumn widget ID.

     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eRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeRRoowwCCoolluummnn((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), XXmmRRoowwCCoolluummnn((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).





     1-302                                            (printed 5/7/92)






     XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg((33XX))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg-A MessageBox TemplateDialog
          convenience creation function

     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mCCrreeaatteeTTeemmppllaatteeDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell. The MessageBox widget's XXmmNNddiiaallooggTTyyppee
          resource is set to XXmmDDIIAALLOOGG__TTEEMMPPLLAATTEE.  By default, the
          TemplateDialog widget contains only the separator child.
          You can build a customized dialog by adding children to the
          TemplateDialog.

          You can create the standard MessageBox pushbuttons, CCaanncceell,
          HHeellpp, and OOKK, by specifying the associated callback and
          label string resources.  Setting XXmmNNssyymmbboollPPiixxmmaapp or
          XXmmNNmmeessssaaggeeSSttrriinngg creates a symbol or message label.

          Use XXttMMaannaaggeeCChhiilldd to pop up the TemplateDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t      Specifies the parent widget ID

          _n_a_m_e        Specifies the name of the created widget

          _a_r_g_l_i_s_t     Specifies the argument list

          _a_r_g_c_o_u_n_t    Specifies the number of attribute/value pairs in
                      the argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).




     1-303                                            (printed 5/7/92)






     XXmmCCrreeaatteeTTeexxtt((33XX))         RReeffeerreennccee PPaaggeess         XXmmCCrreeaatteeTTeexxtt((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeTTeexxtt-The Text widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeTTeexxtt ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeTTeexxtt creates an instance of a Text widget and
          returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of Text and its associated
          resources, see XXmmTTeexxtt((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmTTeexxtt((33XX)).


















     1-304                                            (printed 5/7/92)






     XXmmCCrreeaatteeTTeexxttFFiieelldd((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCrreeaatteeTTeexxttFFiieelldd((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeTTeexxttFFiieelldd-The TextField widget creation function

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

          WWiiddggeett XXmmCCrreeaatteeTTeexxttFFiieelldd ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeTTeexxttFFiieelldd creates an instance of a TextField widget
          and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of TextField and its associated
          resources, see XXmmTTeexxttFFiieelldd((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmTTeexxttFFiieelldd((33XX)).


















     1-305                                            (printed 5/7/92)






     XXmmCCrreeaatteeTToogggglleeBBuuttttoonn((33XX)) RReeffeerreennccee PPaaggeess XXmmCCrreeaatteeTToogggglleeBBuuttttoonn((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeTToogggglleeBBuuttttoonn-The ToggleButton widget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//TToogggglleeBB..hh>>

          WWiiddggeett XXmmCCrreeaatteeTToogggglleeBBuuttttoonn ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeTToogggglleeBBuuttttoonn creates an instance of a ToggleButton
          widget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ToggleButton and its associated
          resources, see XXmmTToogggglleeBBuuttttoonn((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmTToogggglleeBBuuttttoonn((33XX)).

















     1-306                                            (printed 5/7/92)






     XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeettRR(e(e3f3fXeXe)r)reennccee PPXXamamgCgCererseseaatteeTToogggglleeBBuuttttoonnGGaaddggeett((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett-The ToggleButtonGadget creation
          function

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//TToogggglleeBBGG..hh>>

          WWiiddggeett XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeTToogggglleeBBuuttttoonnGGaaddggeett creates an instance of a
          ToggleButtonGadget and returns the associated widget ID.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          For a complete definition of ToggleButtonGadget and its
          associated resources, see XXmmTToogggglleeBBuuttttoonnGGaaddggeett((33XX)).

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

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmTToogggglleeBBuuttttoonnGGaaddggeett((33XX)).

















     1-307                                            (printed 5/7/92)






     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))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg-The MessageBox WarningDialog
          convenience creation function

     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mCCrreeaatteeWWaarrnniinnggDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell.  A WarningDialog warns users of action
          consequences and gives them a choice of resolutions.  It
          includes a symbol, a message, and three buttons.  The
          default symbol is an exclamation point.  The default button
          labels are OOKK, CCaanncceell, and HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the WarningDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).








     1-308                                            (printed 5/7/92)






     XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX))     RReeffeerreennccee PPaaggeess     XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeWWoorrkkAArreeaa-A function that creates a RowColumn work
          area

     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mCCrreeaatteeWWoorrkkAArreeaa ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeWWoorrkkAArreeaa creates an instance of a RowColumn widget
          and returns the associated widget ID.  The widget is created
          with XXmmNNrroowwCCoolluummnnTTyyppee set to XXmmWWOORRKK__AARREEAA.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 RowColumn widget ID.

     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eRRaaddiiooBBooxx((33XX)), XXmmCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)),
          XXmmCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)), XXmmRRoowwCCoolluummnn((33XX)),
          XXmmVVaaCCrreeaatteeSSiimmpplleeCChheecckkBBooxx((33XX)), and
          XXmmVVaaCCrreeaatteeSSiimmpplleeRRaaddiiooBBooxx((33XX)).













     1-309                                            (printed 5/7/92)






     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))RReeffeerreennccee PPaaggeessXXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg((33XX))



     NNAAMMEE
          XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg-The MessageBox WorkingDialog
          convenience creation function

     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mCCrreeaatteeWWoorrkkiinnggDDiiaalloogg ((_p_a_r_e_n_t, _n_a_m_e, _a_r_g_l_i_s_t, _a_r_g_c_o_u_n_t))
               WWiiddggeett    _p_a_r_e_n_t;;
               SSttrriinngg    _n_a_m_e;;
               AArrggLLiisstt   _a_r_g_l_i_s_t;;
               CCaarrddiinnaall  _a_r_g_c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg is a convenience creation function
          that creates a DialogShell and an unmanaged MessageBox child
          of the DialogShell.  A WorkingDialog informs users that
          there is a time-consuming operation in progress and allows
          them to cancel the operation.  It includes a symbol, a
          message, and three buttons.  The default symbol is an
          hourglass.  The default button labels are OOKK, CCaanncceell, and
          HHeellpp.

          Use XXttMMaannaaggeeCChhiilldd to pop up the WorkingDialog (passing the
          MessageBox as the widget parameter); use XXttUUnnmmaannaaggeeCChhiilldd to
          pop it down.


          _p_a_r_e_n_t Specifies the parent widget ID

          _n_a_m_e   Specifies the name of the created widget

          _a_r_g_l_i_s_tSpecifies the argument list

          _a_r_g_c_o_u_n_t
                 Specifies the number of attribute/value pairs in the
                 argument list (_a_r_g_l_i_s_t)


          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 MessageBox widget ID.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmMMeessssaaggeeBBooxx((33XX)).







     1-310                                            (printed 5/7/92)






     XXmmCCvvttCCTTTTooXXmmSSttrriinngg((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCvvttCCTTTTooXXmmSSttrriinngg((33XX))



     NNAAMMEE
          XXmmCCvvttCCTTTTooXXmmSSttrriinngg-A compound string function that converts
          compound text to a compound string

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

          XXmmSSttrriinngg XXmmCCvvttCCTTTTooXXmmSSttrriinngg ((_t_e_x_t))
               cchhaarr        * _t_e_x_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCvvttCCTTTTooXXmmSSttrriinngg converts a (char *) string in compound
          text format to a compound string.  The application must call
          XXttAAppppIInniittiiaalliizzee before calling this function.  Conversion of
          compound text to compound strings is implementation
          dependent.


          _t_e_x_t   Specifies a string in compound text format to be
                 converted to a compound string.


     RREETTUURRNN VVAALLUUEE
          Returns a compound string derived from the compound text.
          The compound text is assumed to be NULL-terminated; NULLs
          within the compound text are handled correctly.  The
          handling of HORIZONTAL TABULATION (HT) control characters
          within the compound text is undefined.  The compound text
          format is described in the X Consortium Standard _C_o_m_p_o_u_n_d
          _T_e_x_t _E_n_c_o_d_i_n_g.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX)).





















     1-311                                            (printed 5/7/92)






     XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee((33XX))RReeffeerreennccee PPaaggeessXXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee((33XX))



     NNAAMMEE
          XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee-A function that converts a string to a
          unit-type value

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

          vvooiidd XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee ((_a_r_g_s, _n_u_m__a_r_g_s, _f_r_o_m__v_a_l, _t_o__v_a_l))
               XXrrmmVVaalluueePPttrr_a_r_g_s;;
               CCaarrddiinnaall  * _n_u_m__a_r_g_s;;
               XXrrmmVVaalluuee  * _f_r_o_m__v_a_l;;
               XXrrmmVVaalluuee  * _t_o__v_a_l;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCvvttSSttrriinnggTTooUUnniittTTyyppee converts a string to a unit type.
          Refer to the man pages for XXmmGGaaddggeett, XXmmMMaannaaggeerr, or
          XXmmPPrriimmiittiivvee for a description of the valid unit types.  Use
          of this function as a resource converter is obsolete.  It
          has been replaced by a new resource converter that uses the
          RepType facility.


          _a_r_g_s   Specifies a list of additional XXrrmmVVaalluuee arguments to
                 the converter if additional context is needed to
                 perform the conversion.  For example, the string-to-
                 font converter needs the widget's screen and the
                 string-to-pixel converter needs the widget's screen
                 and color map.  This argument is often NULL.

          _n_u_m__a_r_g_s
                 Specifies the number of additional XXrrmmVVaalluuee
                 arguments.  This argument is often zero.

          _f_r_o_m__v_a_l
                 Specifies the value to convert

          _t_o__v_a_l Specifies the descriptor to use to return the
                 converted value


     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmGGaaddggeett((33XX)), XXmmMMaannaaggeerr((33XX)), and XXmmPPrriimmiittiivvee((33XX)).












     1-312                                            (printed 5/7/92)






     XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX))



     NNAAMMEE
          XXmmCCvvttXXmmSSttrriinnggTTooCCTT-A compound string function that converts a
          compound string to compound text

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

          cchhaarr ** XXmmCCvvttXXmmSSttrriinnggTTooCCTT ((_s_t_r_i_n_g))
               XXmmSSttrriinngg    _s_t_r_i_n_g;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmCCvvttXXmmSSttrriinnggTTooCCTT converts a compound string to a (char *)
          string in compound text format.  The application must call
          XXttAAppppIInniittiiaalliizzee before calling this function.  The converter
          uses the font list tag associated with a given compound
          string segment to select a compound text format for that
          segment.  A registry defines a mapping between font list
          tags and compound text encoding formats.  The converter uses
          the following algorithm for each compound string segment:


           1.  If the compound string segment tag is mapped to
               XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG in the registry, the converter
               passes the text of the compound string segment to
               XXmmbbTTeexxttLLiissttTTooTTeexxttPPrrooppeerrttyy with an encoding style of
               XXCCoommppoouunnddTTeexxttSSttyyllee and uses the resulting compound text
               for that segment.

           2.  If the compound string segment tag is mapped to an MIT
               registered charset in the registry, the converter
               creates the compound text for that segment using the
               charset (from the registry) and the text of the
               compound string segment as defined in the X Consortium
               Standard _C_o_m_p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

           3.  If the compound string segment tag is mapped to a
               charset in the registry that is neither
               XXmmFFOONNTTLLIISSTT__DDEEFFAAUULLTT__TTAAGG nor an MIT registered charset,
               the converter creates the compound text for that
               segment using the charset (from the registry) and the
               text of the compound string segment as an "extended
               segment" with a variable number of octets per
               character.

           4.  If the compound string segment tag is not mapped in the
               registry, the result is implementation dependent.


          _s_t_r_i_n_g Specifies a compound string to be converted to
                 compound text.




     1-313                                            (printed 5/7/92)






     XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX))    RReeffeerreennccee PPaaggeess    XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX))



     RREETTUURRNN VVAALLUUEE
          Returns a (char *) string in compound text format.  This
          format is described in the X Consortium Standard _C_o_m_p_o_u_n_d
          _T_e_x_t _E_n_c_o_d_i_n_g.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCvvttCCTTTTooXXmmSSttrriinngg((33XX)), XXmmFFoonnttLLiisstt((33XX)),
          XXmmMMaappSSeeggmmeennttEEnnccooddiinngg((33XX)), XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg((33XX)), and
          XXmmSSttrriinngg.














































     1-314                                            (printed 5/7/92)






     XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)) RReeffeerreennccee PPaaggeess XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX))



     NNAAMMEE
          XXmmDDeeaaccttiivvaatteePPrroottooccooll-A VendorShell function that deactivates
          a protocol without removing it

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//XXmm..hh>>
          ##iinncclluuddee <<XXmm//PPrroottooccoollss..hh>>

          vvooiidd XXmmDDeeaaccttiivvaatteePPrroottooccooll ((_s_h_e_l_l, _p_r_o_p_e_r_t_y, _p_r_o_t_o_c_o_l))
               WWiiddggeett    _s_h_e_l_l;;
               AAttoomm      _p_r_o_p_e_r_t_y;;
               AAttoomm      _p_r_o_t_o_c_o_l;;

          vvooiidd XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll ((_s_h_e_l_l, _p_r_o_t_o_c_o_l))
               WWiiddggeett    _s_h_e_l_l;;
               AAttoomm      _p_r_o_t_o_c_o_l;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmDDeeaaccttiivvaatteePPrroottooccooll deactivates a protocol without removing
          it.  It updates the handlers and the _p_r_o_p_e_r_t_y, if the _s_h_e_l_l
          is realized.  It is sometimes useful to allow a protocol's
          state information (callback lists, etc.) to persist, even
          though the client may choose to temporarily resign from the
          interaction.  The main use of this capability is to
          gray/ungray ff..sseenndd__mmssgg entries in the Mwm system menu.  This
          is supported by allowing a _p_r_o_t_o_c_o_l to be in one of two
          states:  active or inactive.  If the _p_r_o_t_o_c_o_l is active and
          the _s_h_e_l_l is realized, the _p_r_o_p_e_r_t_y contains the _p_r_o_t_o_c_o_l
          AAttoomm.  If the _p_r_o_t_o_c_o_l is inactive, the AAttoomm is not present
          in the _p_r_o_p_e_r_t_y.

          XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll is a convenience interface.  It calls
          XXmmDDeeaaccttiivvaatteePPrroottooccooll with the property value set to the atom
          returned by interning WWMM__PPRROOTTOOCCOOLLSS.


          _s_h_e_l_l  Specifies the widget with which the protocol property
                 is associated

          _p_r_o_p_e_r_t_y
                 Specifies the protocol property

          _p_r_o_t_o_c_o_l
                 Specifies the protocol atom (or an int type cast to
                 Atom)


          For a complete definition of VendorShell and its associated
          resources, see VVeennddoorrSShheellll((33XX)).

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



     1-315                                            (printed 5/7/92)






     XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)) RReeffeerreennccee PPaaggeess XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX))



          mmwwmm((11XX)), VVeennddoorrSShheellll((33XX)), XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX)), and
          XXmmIInntteerrnnAAttoomm((33XX)).





















































     1-316                                            (printed 5/7/92)






     XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX))RReeffeerreennccee PPaaggeessXXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll((33XX))



     NNAAMMEE
          XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll-A VendorShell convenience interface
          that deactivates a protocol without removing it

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//XXmm..hh>>
          ##iinncclluuddee <<XXmm//PPrroottooccoollss..hh>>

          vvooiidd XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll ((_s_h_e_l_l, _p_r_o_t_o_c_o_l))
               WWiiddggeett    _s_h_e_l_l;;
               AAttoomm      _p_r_o_t_o_c_o_l;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmDDeeaaccttiivvaatteeWWMMPPrroottooccooll is a convenience interface.  It calls
          XXmmDDeeaaccttiivvaatteePPrroottooccooll with the property value set to the atom
          returned by interning WWMM__PPRROOTTOOCCOOLLSS.


          _s_h_e_l_l  Specifies the widget with which the protocol property
                 is associated

          _p_r_o_t_o_c_o_l
                 Specifies the protocol atom (or an int type cast to
                 Atom)


          For a complete definition of VendorShell and its associated
          resources, see VVeennddoorrSShheellll((33XX)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          VVeennddoorrSShheellll((33XX)), XXmmDDeeaaccttiivvaatteePPrroottooccooll((33XX)), and
          XXmmIInntteerrnnAAttoomm((33XX)).






















     1-317                                            (printed 5/7/92)






     XXmmDDeessttrrooyyPPiixxmmaapp((33XX))      RReeffeerreennccee PPaaggeess      XXmmDDeessttrrooyyPPiixxmmaapp((33XX))



     NNAAMMEE
          XXmmDDeessttrrooyyPPiixxmmaapp-A pixmap caching function that removes a
          pixmap from the pixmap cache

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

          BBoooolleeaann XXmmDDeessttrrooyyPPiixxmmaapp ((_s_c_r_e_e_n, _p_i_x_m_a_p))
               SSccrreeeenn    * _s_c_r_e_e_n;;
               PPiixxmmaapp    _p_i_x_m_a_p;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmDDeessttrrooyyPPiixxmmaapp removes pixmaps that are no longer used.
          Pixmaps are completely freed only when there is no further
          reference to them.


          _s_c_r_e_e_n Specifies the display screen for which the pixmap was
                 requested

          _p_i_x_m_a_p Specifies the pixmap to be destroyed


     RREETTUURRNN VVAALLUUEE
          Returns True when successful; returns False if there is no
          matching screen and pixmap in the pixmap cache.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmIInnssttaallllIImmaaggee((33XX)), XXmmUUnniinnssttaallllIImmaaggee((33XX)), and
          XXmmGGeettPPiixxmmaapp((33XX)).
























     1-318                                            (printed 5/7/92)






     XXmmDDiiaallooggS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mDDiiaallooggSShheellll((33XX))



     NNAAMMEE
          XXmmDDiiaallooggSShheellll-The DialogShell widget class

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//DDiiaallooggSS..hh>>


     DDEESSCCRRIIPPTTIIOONN
          Modal and modeless dialogs use DialogShell as the Shell
          parent.  DialogShell widgets cannot be iconified.  Instead,
          all secondary DialogShell widgets associated with an
          ApplicationShell widget are iconified and de-iconified as a
          group with the primary widget.

          The client indirectly manipulates DialogShell via the
          convenience interfaces during creation, and it can directly
          manipulate its BulletinBoard-derived child.  Much of the
          functionality of DialogShell assumes that its child is a
          BulletinBoard subclass, although it can potentially stand
          alone.

          Setting 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
          DialogShell or its managed child usually sets that resource
          to the same value in both the parent and the child.  When an
          off-the-spot input method exists, the height and width of
          the shell may be greater than those of the managed child in
          order to accommodate the input method.  In this case setting
          XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the shell does not necessarily set
          that resource to the same value in the managed child, and
          setting XXmmNNhheeiigghhtt or XXmmNNwwiiddtthh for the child does not
          necessarily set that resource to the same value in the
          shell.

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

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

        CCllaasssseess
          DialogShell inherits behavior and resources from CCoorree,
          CCoommppoossiittee, SShheellll, WWMMSShheellll, VVeennddoorrSShheellll, and TTrraannssiieennttSShheellll
          classes.




     1-319                                            (printed 5/7/92)






     XXmmDDiiaallooggS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mDDiiaallooggSShheellll((33XX))



          The class pointer is xxmmDDiiaallooggSShheellllWWiiddggeettCCllaassss.

          The class name is XXmmDDiiaallooggSShheellll.

        NNeeww RReessoouurrcceess
          DialogShell defines no new resources but overrides the
          XXmmNNddeelleetteeRReessppoonnssee resource in the VVeennddoorrSShheellll class.

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

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

                          TTrraannssiieennttSShheellll RReessoouurrccee SSeett
         NNaammee              CCllaassss             TTyyppee     DDeeffaauulltt   AAcccceessss
         _____________________________________________________________
         XmNtransientFor   XmCTransientFor   Widget   NULL      CSG

                                   VVeennddoorrSShheellll RReessoouurrccee SSeett
     NNaammee                     CCllaassss                    TTyyppee            DDeeffaauulltt      AAcccceessss
     _____________________________________________________________________________________
     XmNaudibleWarning        XmCAudibleWarning        unsigned char   XmBELL       CSG
     XmNbuttonFontList        XmCButtonFontList        XmFontList      dynamic      CSG
     XmNdefaultFontList       XmCDefaultFontList       XmFontList      dynamic      CG
     XmNdeleteResponse        XmCDeleteResponse        unsigned char   XmUNMAP      CSG
     XmNinputMethod           XmCInputMethod           String          NULL         CSG
     XmNkeyboardFocusPolicy   XmCKeyboardFocusPolicy   unsigned char   XmEXPLICIT   CSG
     XmNlabelFontList         XmCLabelFontList         XmFontList      dynamic      CSG
     XmNmwmDecorations        XmCMwmDecorations        int             -1           CSG
     XmNmwmFunctions          XmCMwmFunctions          int             -1           CSG
     XmNmwmInputMode          XmCMwmInputMode          int             -1           CSG
     XmNmwmMenu               XmCMwmMenu               String          NULL         CSG
     XmNpreeditType           XmCPreeditType           String          dynamic      CSG
     XmNshellUnitType         XmCShellUnitType         unsigned char   XmPIXELS     CSG







     1-320                                            (printed 5/7/92)






     XXmmDDiiaallooggS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mDDiiaallooggSShheellll((33XX))



     XmNtextFontList          XmCTextFontList          XmFontList      dynamic      CSG
     XmNuseAsyncGeometry      XmCUseAsyncGeometry      Boolean         False        CSG

                                  WWMMSShheellll RReessoouurrccee SSeett
     NNaammee               CCllaassss              TTyyppee      DDeeffaauulltt                 AAcccceessss
     ______________________________________________________________________________
     XmNbaseHeight      XmCBaseHeight      int       XtUnspecifiedShellInt   CSG
     XmNbaseWidth       XmCBaseWidth       int       XtUnspecifiedShellInt   CSG
     XmNheightInc       XmCHeightInc       int       XtUnspecifiedShellInt   CSG
     XmNiconMask        XmCIconMask        Pixmap    NULL                    CSG
     XmNiconPixmap      XmCIconPixmap      Pixmap    NULL                    CSG
     XmNiconWindow      XmCIconWindow      Window    NULL                    CSG
     XmNiconX           XmCIconX           int       -1                      CSG
     XmNiconY           XmCIconY           int       -1                      CSG
     XmNinitialState    XmCInitialState    int       NormalState             CSG
     XmNinput           XmCInput           Boolean   True                    CSG
     XmNmaxAspectX      XmCMaxAspectX      int       XtUnspecifiedShellInt   CSG
     XmNmaxAspectY      XmCMaxAspectY      int       XtUnspecifiedShellInt   CSG
     XmNmaxHeight       XmCMaxHeight       int       XtUnspecifiedShellInt   CSG
     XmNmaxWidth        XmCMaxWidth        int       XtUnspecifiedShellInt   CSG
     XmNminAspectX      XmCMinAspectX      int       XtUnspecifiedShellInt   CSG
     XmNminAspectY      XmCMinAspectY      int       XtUnspecifiedShellInt   CSG
     XmNminHeight       XmCMinHeight       int       XtUnspecifiedShellInt   CSG
     XmNminWidth        XmCMinWidth        int       XtUnspecifiedShellInt   CSG
     XmNtitle           XmCTitle           String    dynamic                 CSG
     XmNtitleEncoding   XmCTitleEncoding   Atom      dynamic                 CSG
     XmNtransient       XmCTransient       Boolean   True                    CSG
     XmNwaitForWm       XmCWaitForWm       Boolean   True                    CSG
     XmNwidthInc        XmCWidthInc        int       XtUnspecifiedShellInt   CSG
     XmNwindowGroup     XmCWindowGroup     Window    dynamic                 CSG
     XmNwinGravity      XmCWinGravity      int       dynamic                 CSG
     XmNwmTimeout       XmCWmTimeout       int       5000 ms                 CSG

                                              SShheellll RReessoouurrccee SSeett
     NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
     ____________________________________________________________________________________________________
     XmNallowShellResize       XmCAllowShellResize       Boolean                  False            CG
     XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
     XmNgeometry               XmCGeometry               String                   NULL             CSG
     XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  False            CSG
     XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
     XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
     XmNsaveUnder              XmCSaveUnder              Boolean                  True             CSG
     XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG

                             CCoommppoossiittee RReessoouurrccee SSeett
     NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
     ______________________________________________________________________







     1-321                                            (printed 5/7/92)






     XXmmDDiiaallooggS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mDDiiaallooggSShheellll((33XX))



     XmNchildren         XmCReadOnly         WidgetList    NULL      G
     XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
     XmNnumChildren      XmCReadOnly         Cardinal      0         G

                                                   CCoorree RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
     XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
     XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
     XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
     XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
     XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
     XmNdepth                        XmCDepth                        int              dynamic                CG
     XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
     XmNheight                       XmCHeight                       Dimension        dynamic                CSG
     XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
     XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
     XmNscreen                       XmCScreen                       Screen *         dynamic                CG
     XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
     XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

        TTrraannssllaattiioonnss
          There are no translations for XmDialogShell.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)), CCoorree((33XX)), SShheellll((33XX)), TTrraannssiieennttSShheellll((33XX)),
          WWMMSShheellll((33XX)), VVeennddoorrSShheellll((33XX)), and XXmmCCrreeaatteeDDiiaallooggSShheellll((33XX)).






















     1-322                                            (printed 5/7/92)



 i
