


     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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-211                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).













     2-212                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).














     2-213                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).




     2-214                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).













     2-215                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).













     2-216                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-217                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-218                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-219                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-220                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).





     2-221                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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 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.

          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



     2-222                                            (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))



                 argument list (_a_r_g_l_i_s_t)


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












































     2-223                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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



     2-224                                            (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))



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


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











































     2-225                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-226                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).





     2-227                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-228                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).





     2-229                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-230                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-231                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-232                                            (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

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

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

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















     2-233                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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




     2-234                                            (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))



          _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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mMMaannaaggeerr((33XX)), and
          XXmmRRoowwCCoolluummnn((33XX)).






































     2-235                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMe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)).















     2-236                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).




     2-237                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).





     2-238                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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.
          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



     2-239                                            (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))



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


          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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)), and XXmmRRoowwCCoolluummnn((33XX)).




     2-240                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-241                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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




     2-242                                            (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_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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)), and XXmmRRoowwCCoolluummnn((33XX)).






































     2-243                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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.



     2-244                                            (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))



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





















































     2-245                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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



     2-246                                            (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))



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


          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mMMeennuuSShheellll((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).












     2-247                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-248                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).













     2-249                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).





     2-250                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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)).



     2-251                                            (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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RoowwCCoolluummnn((33XX)), XXmmCCrreeaatteeWWoorrkkAArreeaa((33XX)), and
          XXmmRRoowwCCoolluummnn((33XX)).

















































     2-252                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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eWWoorrkkAArreeaa((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).



     2-253                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-254                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-255                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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.



     2-256                                            (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))



          _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)) and XXmmSSccrroolllleeddWWiinnddooww((33XX)).




































     2-257                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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.





     2-258                                            (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))



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





























     2-259                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).














     2-260                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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.  One additional WWoorrkkAArreeaa child
          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)).



     2-261                                            (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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)).


















































     2-262                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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




     2-263                                            (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))



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










































     2-264                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-265                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).














     2-266                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).















     2-267                                            (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

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

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















     2-268                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).














     2-269                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//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)).














     2-270                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).





     2-271                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>

          WWiiddggeett XXm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eRRoowwCCoolluummnn((33XX)), and
          XXmmRRoowwCCoolluummnn((33XX)).












     2-272                                            (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

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

     SSYYNNOOPPSSIISS
          ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>

          WWiiddggeett XXm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)).




     2-273                                            (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

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

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

          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.


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




















     2-274                                            (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

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

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

          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.





     2-275                                            (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))



          _s_t_r_i_n_g Specifies a compound string to be converted to
                 compound text.


     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)), and XXmmSSttrriinngg.












































     2-276                                            (printed 5/7/92)



 e
