


   XmCreateArrowButton(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ArrowButton widget ID.

   RELATED INFORMATION
     XXmmAArrrroowwBBuuttttoonn((33XX)).



















   2-182






                                                XmCreateArrowButtonGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ArrowButtonGadget widget ID.

   RELATED INFORMATION
     XXmmAArrrroowwBBuuttttoonnGGaaddggeett((33XX)).



















   2-183






   XmCreateBulletinBoard(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the BulletinBoard widget ID.

   RELATED INFORMATION
     XXmmBBuulllleettiinnBBooaarrdd((33XX)).



















   2-184






                                              XmCreateBulletinBoardDialog(3X)



   NAME
     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 con-
     venience creation function

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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 Dia-
     logShell.  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 Bul-
     letinBoard 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)).

   RETURN VALUE
     Returns the BulletinBoard widget ID.

   RELATED INFORMATION
     XXmmBBuulllleettiinnBBooaarrdd((33XX)).











   2-185






   XmCreateCascadeButton(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the CascadeButton widget ID.

   RELATED INFORMATION
     XXmmCCaassccaaddeeBBuuttttoonn((33XX)).


















   2-186






                                              XmCreateCascadeButtonGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the CascadeButtonGadget widget ID.

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






   XmCreateCommand(3X)



   NAME
     XXmmCCrreeaatteeCCoommmmaanndd-The Command widget creation function

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the Command widget ID.

   RELATED INFORMATION
     XXmmCCoommmmaanndd((33XX)).



















   2-188






                                                      XmCreateDialogShell(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the DialogShell widget ID.

   RELATED INFORMATION
     XXmmDDiiaallooggSShheellll((33XX)).



















   2-189






   XmCreateDrawingArea(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the DrawingArea widget ID.

   RELATED INFORMATION
     XXmmDDrraawwiinnggAArreeaa((33XX)).



















   2-190






                                                      XmCreateDrawnButton(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the DrawnButton widget ID.

   RELATED INFORMATION
     XXmmDDrraawwnnBBuuttttoonn((33XX)).



















   2-191






   XmCreateErrorDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 condi-
     tion.  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)).

   RETURN VALUE
     Returns the MessageBox widget ID.

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











   2-192






                                                 XmCreateFileSelectionBox(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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o  An editable text field for the directory mask

       ++oo  A scrolling list of filenames

       ++oo  An editable text field for the selected file

       ++oo  Labels for the list and text fields

       ++o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 addi-
     tional WWoorrkkAArreeaa child may be added to the FileSelectionBox after crea-
     tion.

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

   RETURN VALUE
     Returns the FileSelectionBox widget ID.




   2-193






   XmCreateFileSelectionBox(3X)


   RELATED INFORMATION
     XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).






















































   2-194






                                              XmCreateFileSelectionDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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o  An editable text field for the directory mask

       ++oo  A scrolling list of filenames

       ++oo  An editable text field for the selected file

       ++oo  Labels for the list and text fields

       ++o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 addi-
     tional WWoorrkkAArreeaa child may be added to the FileSelectionBox after crea-
     tion.

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

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

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

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

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

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




   2-195






   XmCreateFileSelectionDialog(3X)


   RETURN VALUE
     Returns the FileSelectionBox widget ID.

   RELATED INFORMATION
     XXmmFFiilleeSSeelleeccttiioonnBBooxx((33XX)).



















































   2-196






                                                             XmCreateForm(3X)



   NAME
     XXmmCCrreeaatteeFFoorrmm-The Form widget creation function

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     XXmmCCrreeaatteeFFoorrmm creates an instance of a Form widget and returns the asso-
     ciated 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)).

   RETURN VALUE
     Returns the Form widget ID.

   RELATED INFORMATION
     XXmmFFoorrmm((33XX)).



















   2-197






   XmCreateFormDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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 FormDia-
     log 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 appli-
     cation 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)).

   RETURN VALUE
     Returns the Form widget ID.

   RELATED INFORMATION
     XXmmFFoorrmm((33XX)).












   2-198






                                                            XmCreateFrame(3X)



   NAME
     XXmmCCrreeaatteeFFrraammee-The Frame widget creation function

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the Frame widget ID.

   RELATED INFORMATION
     XXmmFFrraammee((33XX)).



















   2-199






   XmCreateInformationDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 Dialog-
     Shell.  An InformationDialog gives the user information, such as the
     status of an action.  It includes a symbol, a message, and three but-
     tons.  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 Message-
     Box 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)).

   RETURN VALUE
     Returns the MessageBox widget ID.

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











   2-200






                                                            XmCreateLabel(3X)



   NAME
     XXmmCCrreeaatteeLLaabbeell-The Label widget creation function

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the Label widget ID.

   RELATED INFORMATION
     XXmmLLaabbeell((33XX)).



















   2-201






   XmCreateLabelGadget(3X)



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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the LabelGadget widget ID.

   RELATED INFORMATION
     XXmmLLaabbeellGGaaddggeett((33XX)).



















   2-202






                                                             XmCreateList(3X)



   NAME
     XXmmCCrreeaatteeLLiisstt-The List widget creation function

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     XXmmCCrreeaatteeLLiisstt creates an instance of a List widget and returns the asso-
     ciated 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)).

   RETURN VALUE
     Returns the List widget ID.

   RELATED INFORMATION
     XXmmLLiisstt((33XX)).



















   2-203






   XmCreateMainWindow(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     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;;

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

   RETURN VALUE
     Returns the MainWindow widget ID.

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



















   2-204






                                                          XmCreateMenuBar(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 con-
     venience 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 sys-
     tem.  Typically, a MenuBar is created and placed along the top of the
     application window, and several CascadeButtons are inserted as the chil-
     dren.  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 sup-
     ported by XXmmMMaannaaggeerr.

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

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

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

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

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

     _a_r_g_c_o_u_n_t
            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



   2-205






   XmCreateMenuBar(3X)


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

   RETURN VALUE
     Returns the RowColumn widget ID.

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






                                                        XmCreateMenuShell(3X)



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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the MenuShell widget ID.

   RELATED INFORMATION
     XXmmMMeennuuSShheellll((33XX)).



















   2-207






   XmCreateMessageBox(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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n--
     c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)).

   RETURN VALUE
     Returns the MessageBox widget ID.

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










   2-208






                                                    XmCreateMessageDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 sym-
     bol, 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)).

   RETURN VALUE
     Returns the MessageBox widget ID.

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











   2-209






   XmCreateOptionMenu(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 appli-
     cation 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 Option-
     Menu 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 Option-
     Menu.

     The OptionMenu's Pulldown MenuPane must not contain any ToggleButtons or
     ToggleButtonGadgets.  The results of including CascadeButtons or Cas-
     cadeButtonGadgets 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 CascadeBut-
     tonGadget has a visible 3-D shadow.  The application may change this by
     getting the CascadeButtonGadget ID using XXmmOOppttiioonnBBuuttttoonnGGaaddggeett, and then
     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


   2-210






                                                       XmCreateOptionMenu(3X)


     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, typ-
     ing 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)).

   RETURN VALUE
     Returns the RowColumn widget ID.

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






   XmCreatePanedWindow(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the PanedWindow widget ID.

   RELATED INFORMATION
     XXmmPPaanneeddWWiinnddooww((33XX)).



















   2-212






                                                        XmCreatePopupMenu(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 automati-
     cally created as the parent of the MenuPane.  The parent of the Menu-
     Shell 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 Menu-
     Pane, the MenuShell is automatically created as the real parent of the
     MenuPane.  If the application does not use this convenience function to
     create the RowColumn to function as a Popup MenuPane, it is the
     application's responsibility to create the MenuShell widget.

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

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

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

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

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




   2-213






   XmCreatePopupMenu(3X)


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

   RETURN VALUE
     Returns the RowColumn widget ID.

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






                                                     XmCreatePromptDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the SelectionBox widget ID.

   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).






   2-215






   XmCreatePulldownMenu(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 automat-
     ically 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 dis-
     abled 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 cas-
     cade from a Popup MenuPane.  Pulldown MenuPanes that are to be associ-
     ated with an OptionMenu must be created before the OptionMenu is
     created.

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

     A MenuShell widget is required between the Pulldown MenuPane and its
     parent.  If the application uses this convenience function for creating
     a Pulldown MenuPane, the MenuShell is automatically created as the real
     parent of the MenuPane; otherwise, it is the application's responsibil-
     ity 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:


   2-216






                                                     XmCreatePulldownMenu(3X)



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

       ++o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o  Specifies the parent widget ID

       ++oo  Specifies the name of the created widget

       ++oo  Specifies the argument list

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

   RETURN VALUE
     Returns the RowColumn widget ID.

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






   XmCreatePushButton(3X)



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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the PushButton widget ID.

   RELATED INFORMATION
     XXmmPPuusshhBBuuttttoonn((33XX)).



















   2-218






                                                 XmCreatePushButtonGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the PushButtonGadget widget ID.

   RELATED INFORMATION
     XXmmPPuusshhBBuuttttoonnGGaaddggeett((33XX)).



















   2-219






   XmCreateQuestionDialog(3X)



   NAME
     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 crea-
     tion function

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

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

   RETURN VALUE
     Returns the MessageBox widget ID.

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












   2-220






                                                         XmCreateRadioBox(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

   DESCRIPTION
     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 func-
     tion provides initial values for several RowColumn resources.  It ini-
     tializes 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o--
     m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a--
     t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 ToggleBut-
     tonGadget 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)).

   RETURN VALUE
     Returns the RowColumn widget ID.

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






   XmCreateRowColumn(3X)



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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

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

   RETURN VALUE
     Returns the RowColumn widget ID.

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






                                                            XmCreateScale(3X)



   NAME
     XXmmCCrreeaatteeSSccaallee-The Scale widget creation function

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the Scale widget ID.

   RELATED INFORMATION
     XXmmSSccaallee((33XX)).



















   2-223






   XmCreateScrollBar(3X)



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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ScrollBar widget ID.

   RELATED INFORMATION
     XXmmSSccrroollllBBaarr((33XX)).



















   2-224






                                                     XmCreateScrolledList(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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 con-
     tained 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 appropri-
     ate.

     This function forces the following initial values for ScrolledWindow
     resources:

       ++o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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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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 Scrol-
     ledList, 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)


   2-225






   XmCreateScrolledList(3X)



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

   RETURN VALUE
     Returns the List widget ID.

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






                                                     XmCreateScrolledText(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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 con-
     tained 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 appropri-
     ate.

     This function forces the following initial values for ScrolledWindow
     resources:

       ++o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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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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 Scrol-
     ledText, 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



   2-227






   XmCreateScrolledText(3X)


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

   RETURN VALUE
     Returns the Text widget ID.

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






                                                   XmCreateScrolledWindow(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ScrolledWindow widget ID.

   RELATED INFORMATION
     XXmmSSccrroolllleeddWWiinnddooww((33XX)).



















   2-229






   XmCreateSelectionBox(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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o  A scrolling list of alternatives

       ++oo  An editable text field for the selected alternative

       ++oo  Labels for the list and text field

       ++o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 Dialog-
     Shell it is managed, and otherwise it is unmanaged.  One additional WWoorr--
     k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,












   2-230






                                                     XmCreateSelectionBox(3X)


     see XXmmSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the SelectionBox widget ID.

   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).

















































   2-231






   XmCreateSelectionDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     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o  A scrolling list of alternatives

       ++oo  An editable text field for the selected alternative

       ++oo  Labels for the text field

       ++o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 addi-
     tional 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 Selection-
     Box 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,






   2-232






                                                  XmCreateSelectionDialog(3X)


     see XXmmSSeelleeccttiioonnBBooxx((33XX)).

   RETURN VALUE
     Returns the SelectionBox widget ID.

   RELATED INFORMATION
     XXmmSSeelleeccttiioonnBBooxx((33XX)).

















































   2-233






   XmCreateSeparator(3X)



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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the Separator widget ID.

   RELATED INFORMATION
     XXmmSSeeppaarraattoorr((33XX)).



















   2-234






                                                  XmCreateSeparatorGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the SeparatorGadget widget ID.

   RELATED INFORMATION
     XXmmSSeeppaarraattoorrGGaaddggeett((33XX)).



















   2-235






   XmCreateText(3X)



   NAME
     XXmmCCrreeaatteeTTeexxtt-The Text widget creation function

   AES SUPPORT LEVEL
     Full-use

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

   DESCRIPTION
     XXmmCCrreeaatteeTTeexxtt creates an instance of a Text widget and returns the asso-
     ciated 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)).

   RETURN VALUE
     Returns the Text widget ID.

   RELATED INFORMATION
     XXmmTTeexxtt((33XX)).



















   2-236






                                                        XmCreateTextField(3X)



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

   AES SUPPORT LEVEL
     Trial-use

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

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

   RETURN VALUE
     Returns the TextField widget ID.

   RELATED INFORMATION
     XXmmTTeexxttFFiieelldd((33XX)).



















   2-237






   XmCreateToggleButton(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ToggleButton widget ID.

   RELATED INFORMATION
     XXmmTToogggglleeBBuuttttoonn((33XX)).



















   2-238






                                               XmCreateToggleButtonGadget(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

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

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

   RETURN VALUE
     Returns the ToggleButtonGadget widget ID.

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






   XmCreateWarningDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

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

   RETURN VALUE
     Returns the MessageBox widget ID.

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











   2-240






                                                         XmCreateWorkArea(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Trial-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXm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;;

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

   RETURN VALUE
     Returns the RowColumn widget ID.

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






   XmCreateWorkingDialog(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Full-use

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXm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;;

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

   RETURN VALUE
     Returns the MessageBox widget ID.

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











   2-242






                                                        XmCvtCTToXmString(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Trial-use

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

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

   RETURN VALUE
     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) con-
     trol 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.

   RELATED INFORMATION
     XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX)).

























   2-243






   XmCvtXmStringToCT(3X)



   NAME
     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

   AES SUPPORT LEVEL
     Trial-use

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

   DESCRIPTION
     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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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 Stan-
          dard _C_o_m_p_o_u_n_d _T_e_x_t _E_n_c_o_d_i_n_g.

      3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 vari-
          able number of octets per character.

      44..  If the compound string segment tag is not mapped in the registry,
          the result is implementation dependent.

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

   RETURN VALUE
     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.

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



 _
