


     XXmmLLiissttDDeelleetteeAAllllIItteemmss((33XX)) RReeffeerreennccee PPaaggeess XXmmLLiissttDDeelleetteeAAllllIItteemmss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteeAAllllIItteemmss-A List function that deletes all items
          from the list

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

          vvooiidd XXmmLLiissttDDeelleetteeAAllllIItteemmss ((_w_i_d_g_e_t))
               WWiiddggeett    _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteeAAllllIItteemmss deletes all items from the list.


          _w_i_d_g_e_t Specifies the ID of the List from whose list the
                 items are deleted


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

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































     1-526                                            (printed 5/7/92)






     XXmmLLiissttDDeelleetteeIItteemm((33XX))     RReeffeerreennccee PPaaggeess     XXmmLLiissttDDeelleetteeIItteemm((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteeIItteemm-A List function that deletes an item from
          the list

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

          vvooiidd XXmmLLiissttDDeelleetteeIItteemm ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteeIItteemm deletes the first item in the list that
          matches _i_t_e_m.  A warning message appears if the item does
          not exist.


          _w_i_d_g_e_t Specifies the ID of the List from whose list an item
                 is deleted

          _i_t_e_m   Specifies the text of the item to be deleted from the
                 list


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

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

























     1-527                                            (printed 5/7/92)






     XXmmLLiissttDDeelleetteeIItteemmss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttDDeelleetteeIItteemmss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteeIItteemmss-A List function that deletes items from
          the list

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

          vvooiidd XXmmLLiissttDDeelleetteeIItteemmss ((_w_i_d_g_e_t, _i_t_e_m_s, _i_t_e_m__c_o_u_n_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  **_i_t_e_m_s;;
               iinntt       _i_t_e_m__c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteeIItteemmss deletes the specified items from the list.
          For each element of _i_t_e_m_s, the first item in the list that
          matches that element is deleted.  A warning message appears
          if any of the items do not exist.


          _w_i_d_g_e_t Specifies the ID of the List from whose list an item
                 is deleted

          _i_t_e_m_s  Specifies a pointer to items to be deleted from the
                 list

          _i_t_e_m__c_o_u_n_t
                 Specifies the number of elements in _i_t_e_m_s This number
                 must be non-negative.


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

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



















     1-528                                            (printed 5/7/92)






     XXmmLLiissttDDeelleetteeIItteemmssPPooss((33XX)) RReeffeerreennccee PPaaggeess XXmmLLiissttDDeelleetteeIItteemmssPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteeIItteemmssPPooss-A List function that deletes items from
          the list starting at the given position

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

          vvooiidd XXmmLLiissttDDeelleetteeIItteemmssPPooss ((_w_i_d_g_e_t, _i_t_e_m__c_o_u_n_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _i_t_e_m__c_o_u_n_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteeIItteemmssPPooss deletes the specified number of items
          from the list starting at the specified position.


          _w_i_d_g_e_t Specifies the ID of the List from whose list an item
                 is deleted.

          _i_t_e_m__c_o_u_n_t
                 Specifies the number of items to be deleted.  This
                 number must be non-negative.

          _p_o_s_i_t_i_o_n
                 Specifies the position in the list of the first item
                 to be deleted.  A value of 1 indicates that the first
                 deleted item is the first item in the list; a value
                 of 2 indicates that it is the second item; and so on.


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

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


















     1-529                                            (printed 5/7/92)






     XXmmLLiissttDDeelleetteePPooss((33XX))      RReeffeerreennccee PPaaggeess      XXmmLLiissttDDeelleetteePPooss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteePPooss-A List function that deletes an item from a
          list at a specified position

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

          vvooiidd XXmmLLiissttDDeelleetteePPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteePPooss deletes an item at a specified position.  A
          warning message appears if the position does not exist.


          _w_i_d_g_e_t Specifies the ID of the List from which an item is to
                 be deleted.

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item to be deleted.  A
                 value of 1 indicates that the first item in the list
                 is deleted; a value of 2 indicates that the second
                 item is deleted; and so on.  A value of 0 indicates
                 that the last item in the list is deleted.


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

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






















     1-530                                            (printed 5/7/92)






     XXmmLLiissttDDeelleetteePPoossiittiioonnss((33XX))RReeffeerreennccee PPaaggeessXXmmLLiissttDDeelleetteePPoossiittiioonnss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeelleetteePPoossiittiioonnss-A List function that deletes items
          from a list based on an array of positions

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

          vvooiidd XXmmLLiissttDDeelleetteePPoossiittiioonnss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n__l_i_s_t, _p_o_s_i_t_i_o_n__c_o_u_n_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       **_p_o_s_i_t_i_o_n__l_i_s_t;;
               iinntt       _p_o_s_i_t_i_o_n__c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeelleetteePPoossiittiioonnss deletes noncontiguous items from a
          list.  The function deletes all items whose corresponding
          positions appear in the _p_o_s_i_t_i_o_n__l_i_s_t array. A warning
          message is displayed if a specified position is invalid;
          that is, the value is 0, a negative integer, or a number
          greater than the number of items in the list.


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

          _p_o_s_i_t_i_o_n__l_i_s_t
                      Specifies an array of the item positions to be
                      deleted.  The position of the first item in the
                      list is 1; the position of the second item is 2;
                      and so on.

          _p_o_s_i_t_i_o_n__c_o_u_n_t
                      Specifies the number of elements in the
                      _p_o_s_i_t_i_o_n__l_i_s_t.


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

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















     1-531                                            (printed 5/7/92)






     XXmmLLiissttDDeesseelleeccttAAllllIItteemmss((33XX))RReeffeerreennccee PPaaggeessXXmmLLiissttDDeesseelleeccttAAllllIItteemmss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeesseelleeccttAAllllIItteemmss-A List function that unhighlights and
          removes all items from the selected list

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

          vvooiidd XXmmLLiissttDDeesseelleeccttAAllllIItteemmss ((_w_i_d_g_e_t))
               WWiiddggeett    _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeesseelleeccttAAllllIItteemmss unhighlights and removes all items
          from the selected list.


          _w_i_d_g_e_t Specifies the ID of the List widget from whose list
                 all selected items are deselected


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

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






























     1-532                                            (printed 5/7/92)






     XXmmLLiissttDDeesseelleeccttIItteemm((33XX))   RReeffeerreennccee PPaaggeess   XXmmLLiissttDDeesseelleeccttIItteemm((33XX))



     NNAAMMEE
          XXmmLLiissttDDeesseelleeccttIItteemm-A List function that deselects the
          specified item from the selected list

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

          vvooiidd XXmmLLiissttDDeesseelleeccttIItteemm ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeesseelleeccttIItteemm unhighlights and removes from the
          selected list the first item in the list that matches _i_t_e_m.


          _w_i_d_g_e_t Specifies the ID of the List from whose list an item
                 is deselected

          _i_t_e_m   Specifies the item to be deselected from the list


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

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



























     1-533                                            (printed 5/7/92)






     XXmmLLiissttDDeesseelleeccttPPooss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttDDeesseelleeccttPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttDDeesseelleeccttPPooss-A List function that deselects an item at
          a specified position in the list

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

          vvooiidd XXmmLLiissttDDeesseelleeccttPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttDDeesseelleeccttPPooss unhighlights the item at the specified
          position and deletes it from the list of selected items.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item to be deselected.
                 A value of 1 indicates that the first item in the
                 list is deselected; a value of 2 indicates that the
                 second item is deselected; and so on.  A value of 0
                 indicates that the last item in the list is
                 deselected.


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

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






















     1-534                                            (printed 5/7/92)






     XXmmLLiissttGGeettKKbbddIItteemmPPooss((33XX))  RReeffeerreennccee PPaaggeess  XXmmLLiissttGGeettKKbbddIItteemmPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttGGeettKKbbddIItteemmPPooss-A List function that returns the
          position of the item at the location cursor

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

          iinntt XXmmLLiissttGGeettKKbbddIItteemmPPooss ((_w_i_d_g_e_t))
               WWiiddggeett    _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttGGeettKKbbddIItteemmPPooss returns the position of the list item at
          the location cursor.


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


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

     RREETTUURRNN VVAALLUUEE
          Returns the position of the current keyboard item.  A value
          of 1 indicates that the location cursor is at the first item
          of the list; a value of 2 indicates that it is at the second
          item; and so on.  A value of 0 indicates the List widget is
          empty.

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
























     1-535                                            (printed 5/7/92)






     XXmmLLiissttGGeettMMaattcchhPPooss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttGGeettMMaattcchhPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttGGeettMMaattcchhPPooss-A List function that returns all instances
          of an item in the list

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

          BBoooolleeaann XXmmLLiissttGGeettMMaattcchhPPooss ((_w_i_d_g_e_t, _i_t_e_m, _p_o_s_i_t_i_o_n__l_i_s_t, _p_o_s_i_t_i_o_n__c_o_u_n_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;
               iinntt       ****_p_o_s_i_t_i_o_n__l_i_s_t;;
               iinntt       **_p_o_s_i_t_i_o_n__c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttGGeettMMaattcchhPPooss is a Boolean function that returns an
          array of positions where a specified item is found in a
          List.


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

          _i_t_e_m   Specifies the item to search for.

          _p_o_s_i_t_i_o_n__l_i_s_t
                 Returns an array of positions at which the item
                 occurs in the List.  The position of the first item
                 in the list is 1; the position of the second item is
                 2; and so on.  When the return value is TRUE,
                 XXmmLLiissttGGeettMMaattcchhPPooss allocates memory for this array.
                 The caller is responsible for freeing this memory.

          _p_o_s_i_t_i_o_n__c_o_u_n_t
                 Returns the number of elements in the _p_o_s_i_t_i_o_n__l_i_s_t.


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

     RREETTUURRNN VVAALLUUEE
          Returns TRUE if the specified item is present in the list,
          and FALSE if it is not.

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










     1-536                                            (printed 5/7/92)






     XXmmLLiissttGGeettSSeelleecctteeddPPooss((33XX)) RReeffeerreennccee PPaaggeess XXmmLLiissttGGeettSSeelleecctteeddPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttGGeettSSeelleecctteeddPPooss-A List function that returns the
          position of every selected item in the list

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

          BBoooolleeaann XXmmLLiissttGGeettSSeelleecctteeddPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n__l_i_s_t, _p_o_s_i_t_i_o_n__c_o_u_n_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       ****_p_o_s_i_t_i_o_n__l_i_s_t;;
               iinntt       **_p_o_s_i_t_i_o_n__c_o_u_n_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttGGeettSSeelleecctteeddPPooss is a Boolean function that returns an
          array of the positions of the selected items in a List.


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

          _p_o_s_i_t_i_o_n__l_i_s_t
                 Returns an array of the positions of the selected
                 items in the List.  The position of the first item in
                 the list is 1; the position of the second item is 2;
                 and so on.  When the return value is TRUE,
                 XXmmLLiissttGGeettSSeelleecctteeddPPooss allocates memory for this array.
                 The caller is responsible for freeing this memory.

          _p_o_s_i_t_i_o_n__c_o_u_n_t
                 Returns the number of elements in the _p_o_s_i_t_i_o_n__l_i_s_t.


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

     RREETTUURRNN VVAALLUUEE
          Returns TRUE if the list has any selected items, and FALSE
          if it does not.

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














     1-537                                            (printed 5/7/92)






     XXmmLLiissttIItteemmEExxiissttss((33XX))     RReeffeerreennccee PPaaggeess     XXmmLLiissttIItteemmEExxiissttss((33XX))



     NNAAMMEE
          XXmmLLiissttIItteemmEExxiissttss-A List function that checks if a specified
          item is in the list

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

          BBoooolleeaann XXmmLLiissttIItteemmEExxiissttss ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttIItteemmEExxiissttss is a Boolean function that checks if a
          specified item is present in the list.


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

          _i_t_e_m   Specifies the item whose presence is checked


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

     RREETTUURRNN VVAALLUUEE
          Returns True if the specified item is present in the list.

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

























     1-538                                            (printed 5/7/92)






     XXmmLLiissttIItteemmPPooss((33XX))        RReeffeerreennccee PPaaggeess        XXmmLLiissttIItteemmPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttIItteemmPPooss-A List function that returns the position of
          an item in the list

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

          iinntt XXmmLLiissttIItteemmPPooss ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttIItteemmPPooss returns the position of the first instance of
          the specified item in a List.


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

          _i_t_e_m   Specifies the item whose position is returned


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

     RREETTUURRNN VVAALLUUEE
          Returns the position in the list of the first instance of
          the specified item.  The position of the first item in the
          list is 1; the position of the second item is 2; and so on.
          This function returns 0 if the item is not found.

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






















     1-539                                            (printed 5/7/92)






     XXmmLLiissttPPoossSSeelleecctteedd((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttPPoossSSeelleecctteedd((33XX))



     NNAAMMEE
          XXmmLLiissttPPoossSSeelleecctteedd-A List function that determines if the
          list item at a specified position is selected

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

          BBoooolleeaann XXmmLLiissttPPoossSSeelleecctteedd ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmPPoossSSeelleecctteedd determines if the list item at the specified
          position is selected or not.


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

          _p_o_s_i_t_i_o_n  Specifies the position of the list item.  A value
                    of 1 indicates the first item in the list; a value
                    of 2 indicates the second item; and so on.  A
                    value of 0 specifies the last item in the list.


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

     RREETTUURRNN VVAALLUUEE
          Returns True if the list item is selected; otherwise,
          returns False if the item is not selected or the specified
          position is invalid.

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




















     1-540                                            (printed 5/7/92)






     XXmmLLiissttPPoossTTooBBoouunnddss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttPPoossTTooBBoouunnddss((33XX))



     NNAAMMEE
          XXmmLLiissttPPoossTTooBBoouunnddss-A List function that returns the bounding
          box of an item at a specified position in a list

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

          BBoooolleeaann XXmmLLiissttPPoossTTooBBoouunnddss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n, _x, _y, _w_i_d_t_h, _h_e_i_g_h_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;
               PPoossiittiioonn  **_x;;
               PPoossiittiioonn  **_y;;
               DDiimmeennssiioonn **_w_i_d_t_h;;
               DDiimmeennssiioonn **_h_e_i_g_h_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttPPoossTTooBBoouunnddss returns the coordinates of an item within
          a list and the dimensions of its bounding box.  The function
          returns the associated x and y coordinates of the upper left
          corner of the bounding box relative to the upper left corner
          of the List widget, as well as the width and the height of
          the box.  The caller can pass a NULL value for the _x, _y,
          _w_i_d_t_h, or _h_e_i_g_h_t parameters to indicate that the return
          value for that parameter is not requested.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the specified item. A value
                 of 1 indicates the first item in the list; a value of
                 2 indicates the second item; and so on.  A value of 0
                 specifies the last item in the list.

          _x      Specifies a pointer to the returned x coordinate of
                 the item.

          _y      Specifies the pointer to the returned y coordinate of
                 the item.

          _w_i_d_t_h  Specifies the pointer to the returned width of the
                 item.

          _h_e_i_g_h_t Specifies the pointer to the returned height of the
                 item.


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

     RREETTUURRNN VVAALLUUEE



     1-541                                            (printed 5/7/92)






     XXmmLLiissttPPoossTTooBBoouunnddss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttPPoossTTooBBoouunnddss((33XX))



          If the item at the specified position is not visible,
          returns False, and the returned values (if any) are
          undefined.  Otherwise, returns True.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLiisstt((33XX)) and XXmmLLiissttYYTTooPPooss((33XX)).

















































     1-542                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceeIItteemmss((33XX))   RReeffeerreennccee PPaaggeess   XXmmLLiissttRReeppllaacceeIItteemmss((33XX))



     NNAAMMEE
          XXmmLLiissttRReeppllaacceeIItteemmss-A List function that replaces the
          specified elements in the list

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

          vvooiidd XXmmLLiissttRReeppllaacceeIItteemmss ((_w_i_d_g_e_t, _o_l_d__i_t_e_m_s, _i_t_e_m__c_o_u_n_t, _n_e_w__i_t_e_m_s))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  **_o_l_d__i_t_e_m_s;;
               iinntt       _i_t_e_m__c_o_u_n_t;;
               XXmmSSttrriinngg  **_n_e_w__i_t_e_m_s;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttRReeppllaacceeIItteemmss replaces each specified item of the list
          with a corresponding new item.  When the items are inserted
          into the list, they are compared with the current
          XXmmNNsseelleecctteeddIItteemmss list.  If any of the new items matches an
          item on the selected list, it appears selected.


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

          _o_l_d__i_t_e_m_s
                 Specifies the items to be replaced

          _i_t_e_m__c_o_u_n_t
                 Specifies the number of items in _o_l_d__i_t_e_m_s and
                 _n_e_w__i_t_e_m_s This number must be non-negative.

          _n_e_w__i_t_e_m_s
                 Specifies the replacement items


          Every occurrence of each element of _o_l_d__i_t_e_m_s is replaced
          with the corresponding element from _n_e_w__i_t_e_m_s.  That is, the
          first element of _o_l_d__i_t_e_m_s is replaced with the first
          element of _n_e_w__i_t_e_m_s.  The second element of _o_l_d__i_t_e_m_s is
          replaced with the second element of _n_e_w__i_t_e_m_s, and so on
          until _i_t_e_m__c_o_u_n_t is reached.

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

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








     1-543                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceeIItteemmssPPooss((33XX))RReeffeerreennccee PPaaggeessXXmmLLiissttRReeppllaacceeIItteemmssPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttRReeppllaacceeIItteemmssPPooss-A List function that replaces the
          specified elements in the list

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

          vvooiidd XXmmLLiissttRReeppllaacceeIItteemmssPPooss ((_w_i_d_g_e_t, _n_e_w__i_t_e_m_s, _i_t_e_m__c_o_u_n_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  **_n_e_w__i_t_e_m_s;;
               iinntt       _i_t_e_m__c_o_u_n_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttRReeppllaacceeIItteemmssPPooss replaces the specified number of items
          of the List with new items, starting at the specified
          position in the List.  When the items are inserted into the
          list, they are compared with the current XXmmNNsseelleecctteeddIItteemmss
          list.  If any of the new items matches an item on the
          selected list, it appears selected.


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

          _n_e_w__i_t_e_m_s
                 Specifies the replacement items.

          _i_t_e_m__c_o_u_n_t
                 Specifies the number of items in _n_e_w__i_t_e_m_s and the
                 number of items in the list to replace.  This number
                 must be non-negative.

          _p_o_s_i_t_i_o_n
                 Specifies the position of the first item in the list
                 to be replaced.  A value of 1 indicates that the
                 first item replaced is the first item in the list; a
                 value of 2 indicates that it is the second item; and
                 so on.

                 Beginning with the item specified in _p_o_s_i_t_i_o_n,
                 _i_t_e_m__c_o_u_n_t items in the list are replaced with the
                 corresponding elements from _n_e_w__i_t_e_m_s.  That is, the
                 item at _p_o_s_i_t_i_o_n is replaced with the first element
                 of _n_e_w__i_t_e_m_s; the item after _p_o_s_i_t_i_o_n is replaced
                 with the second element of _n_e_w__i_t_e_m_s; and so on,
                 until _i_t_e_m__c_o_u_n_t is reached.


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




     1-544                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceeIItteemmssPPooss((33XX))RReeffeerreennccee PPaaggeessXXmmLLiissttRReeppllaacceeIItteemmssPPooss((33XX))



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





















































     1-545                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceeIItteemmssPPoossUUnnsseellRReeeecfcfteteererdedeXX(nm(nm3cL3cLXeiXei) s)sPtPtaRaRgegeepepslslaacceeIItteemmssPPoossUUnnsseelleecctteedd((33XX))



     NNAAMMEE
          XXmmLLiissttRReeppllaacceeIItteemmssPPoossUUnnsseelleecctteedd-A List function that
          replaces items in a list without selecting the replacement
          items

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

          vvooiidd XXmmLLiissttRReeppllaacceeIItteemmssPPoossUUnnsseelleecctteedd ((_w_i_d_g_e_t, _n_e_w__i_t_e_m_s, _i_t_e_m__c_o_u_n_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  **_n_e_w__i_t_e_m_s;;
               iinntt       _i_t_e_m__c_o_u_n_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttRReeppllaacceeIItteemmssPPoossUUnnsseelleecctteedd replaces the specified
          number of items in the list with new items, starting at the
          given position.  The replacement items remain unselected,
          even if they currently appear in the XXmmNNsseelleecctteeddIItteemmss list.


          _w_i_d_g_e_t    Specifies the ID of the List widget to replace
                    items in.

          _n_e_w__i_t_e_m_s Specifies a pointer to the replacement items.

          _i_t_e_m__c_o_u_n_t
                    Specifies the number of elements in _n_e_w__i_t_e_m_s and
                    the number of items in the list to replace.  This
                    number must be non-negative.

          _p_o_s_i_t_i_o_n  Specifies the position of the first item in the
                    list to be replaced.  A value of 1 indicates that
                    the first item replaced is the first item in the
                    list;  a value of 2 indicates that it is the
                    second item; and so on.

                    Beginning with the item specified in _p_o_s_i_t_i_o_n,
                    _i_t_e_m__c_o_u_n_t items in the list are replaced with the
                    corresponding elements from _n_e_w__i_t_e_m_s.  That is,
                    the item at _p_o_s_i_t_i_o_n is replaced with the first
                    element of _n_e_w__i_t_e_m_s; the item after _p_o_s_i_t_i_o_n is
                    replaced with the second element of _n_e_w__i_t_e_m_s; and
                    so on, until _i_t_e_m__c_o_u_n_t is reached.


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

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



     1-546                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceeIItteemmssUUnnsseelleeccttRReeeedfdf(e(e3r3rXeXe)n)ncceeXX mmPLPLaiaigsgsetetsRsReeppllaacceeIItteemmssUUnnsseelleecctteedd((33XX))



     NNAAMMEE
          XXmmLLiissttRReeppllaacceeIItteemmssUUnnsseelleecctteedd-A List function that replaces
          items in a list

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

          vvooiidd XXmmLLiissttRReeppllaacceeIItteemmssUUnnsseelleecctteedd ((_w_i_d_g_e_t, _o_l_d__i_t_e_m_s, _i_t_e_m__c_o_u_n_t, _n_e_w__i_t_e_m_s))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  **_o_l_d__i_t_e_m_s;;
               iinntt       _i_t_e_m__c_o_u_n_t;;
               XXmmSSttrriinngg  **_n_e_w__i_t_e_m_s;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttRReeppllaacceeIItteemmssUUnnsseelleecctteedd replaces each specified item in
          the list with a corresponding new item.  The replacement
          items remain unselected, even if they currently appear in
          the XXmmNNsseelleecctteeddIItteemmss list.


          _w_i_d_g_e_t    Specifies the ID of the List widget to replace
                    items in.

          _o_l_d__i_t_e_m_s Specifies a pointer to the list items to be
                    replaced.

          _i_t_e_m__c_o_u_n_t
                    Specifies the number of elements in _o_l_d__i_t_e_m_s and
                    _n_e_w__i_t_e_m_s.  This number must be non-negative.

          _n_e_w__i_t_e_m_s Specifies a pointer to the replacement items.
                    Every occurrence of each element of _o_l_d__i_t_e_m_s is
                    replaced with the corresponding element from
                    _n_e_w__i_t_e_m_s.  That is, the first element of
                    _o_l_d__i_t_e_m_s is replaced with the first element of
                    _n_e_w__i_t_e_m_s.  The second element of _o_l_d__i_t_e_m_s is
                    replaced with the second element of _n_e_w__i_t_e_m_s, and
                    so on until _i_t_e_m__c_o_u_n_t is reached.  If an element
                    in _o_l_d__i_t_e_m_s does not exist in the list, the
                    corresponding entry in _n_e_w__i_t_e_m_s is skipped.


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

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







     1-547                                            (printed 5/7/92)






     XXmmLLiissttRReeppllaacceePPoossiittiioonnss((33XX))RReeffeerreennccee PPaaggeessXXmmLLiissttRReeppllaacceePPoossiittiioonnss((33XX))



     NNAAMMEE
          XXmmLLiissttRReeppllaacceePPoossiittiioonnss-A List function that replaces items
          in a list based on position

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

          vvooiidd XXmmLLiissttRReeppllaacceePPoossiittiioonnss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n__l_i_s_t, _i_t_e_m__l_i_s_t, _i_t_e_m__c_o_u_n_t))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       **_p_o_s_i_t_i_o_n__l_i_s_t;;
               XXmmSSttrriinngg  **_i_t_e_m__l_i_s_t;;
               iinntt       _i_t_e_m__c_o_u_n_t;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttRReeppllaacceePPoossiittiioonnss replaces noncontiguous items in a
          list.  The item at each position specified in _p_o_s_i_t_i_o_n__l_i_s_t
          is replaced with the corresponding entry in _i_t_e_m__l_i_s_t. When
          the items are inserted into the list, they are compared with
          the current XXmmNNsseelleecctteeddIItteemmss list.  Any of the new items
          that match items on the selected list appears selected.  A
          warning message is displayed if a specified position is
          invalid; that is, the value is 0, a negative integer, or a
          number greater than the number of items in the list.


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

          _p_o_s_i_t_i_o_n__l_i_s_t
                    Specifies an array of the positions of items to be
                    replaced.  The position of the first item in the
                    list is 1; the position of the second item is 2;
                    and so on.

          _i_t_e_m__l_i_s_t Specifies an array of the replacement items.

          _i_t_e_m__c_o_u_n_t
                    Specifies the number of elements in _p_o_s_i_t_i_o_n__l_i_s_t
                    and _i_t_e_m__l_i_s_t.  This number must be non-negative.


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

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









     1-548                                            (printed 5/7/92)






     XXmmLLiissttSSeelleeccttIItteemm((33XX))     RReeffeerreennccee PPaaggeess     XXmmLLiissttSSeelleeccttIItteemm((33XX))



     NNAAMMEE
          XXmmLLiissttSSeelleeccttIItteemm-A List function that selects an item in the
          list

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

          vvooiidd XXmmLLiissttSSeelleeccttIItteemm ((_w_i_d_g_e_t, _i_t_e_m, _n_o_t_i_f_y))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;
               BBoooolleeaann   _n_o_t_i_f_y;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeelleeccttIItteemm highlights and adds to the selected list
          the first item in the list that matches _i_t_e_m.


          _w_i_d_g_e_t Specifies the ID of the List widget from whose list
                 an item is selected

          _i_t_e_m   Specifies the item to be selected in the List widget

          _n_o_t_i_f_y Specifies a Boolean value that when True invokes the
                 selection callback for the current mode.  From an
                 application interface view, calling this function
                 with _n_o_t_i_f_y True is indistinguishable from a user-
                 initiated selection action.


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

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




















     1-549                                            (printed 5/7/92)






     XXmmLLiissttSSeelleeccttPPooss((33XX))      RReeffeerreennccee PPaaggeess      XXmmLLiissttSSeelleeccttPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttSSeelleeccttPPooss-A List function that selects an item at a
          specified position in the list

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

          vvooiidd XXmmLLiissttSSeelleeccttPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n, _n_o_t_i_f_y))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;
               BBoooolleeaann   _n_o_t_i_f_y;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeelleeccttPPooss highlights a List item at the specified
          position and adds it to the list of selected items.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item to be selected.  A
                 value of 1 indicates that the first item in the list
                 is selected; a value of 2 indicates that the second
                 item is selected; and so on.  A value of 0 indicates
                 that the last item in the list is selected.

          _n_o_t_i_f_y Specifies a Boolean value that when True invokes the
                 selection callback for the current mode.  From an
                 application interface view, calling this function
                 with _n_o_t_i_f_y True is indistinguishable from a user-
                 initiated selection action.


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

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
















     1-550                                            (printed 5/7/92)






     XXmmLLiissttSSeettAAddddMMooddee((33XX))     RReeffeerreennccee PPaaggeess     XXmmLLiissttSSeettAAddddMMooddee((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettAAddddMMooddee-A List function that sets add mode in the
          list

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

          vvooiidd XXmmLLiissttSSeettAAddddMMooddee ((_w_i_d_g_e_t, _s_t_a_t_e))
               WWiiddggeett    _w_i_d_g_e_t;;
               BBoooolleeaann   _s_t_a_t_e;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettAAddddMMooddee allows applications control over Add Mode
          in the extended selection model.


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

          _s_t_a_t_e  Specifies whether to activate or deactivate Add Mode.
                 If _s_t_a_t_e is True, Add Mode is activated.  If _s_t_a_t_e is
                 False, Add Mode is deactivated.


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

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


























     1-551                                            (printed 5/7/92)






     XXmmLLiissttSSeettBBoottttoommIItteemm((33XX))  RReeffeerreennccee PPaaggeess  XXmmLLiissttSSeettBBoottttoommIItteemm((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettBBoottttoommIItteemm-A List function that makes an existing
          item the last visible item in the list

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

          vvooiidd XXmmLLiissttSSeettBBoottttoommIItteemm ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettBBoottttoommIItteemm makes the first item in the list that
          matches _i_t_e_m the last visible item in the list.


          _w_i_d_g_e_t Specifies the ID of the List widget from whose list
                 an item is made the last visible

          _i_t_e_m   Specifies the item


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

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



























     1-552                                            (printed 5/7/92)






     XXmmLLiissttSSeettBBoottttoommPPooss((33XX))   RReeffeerreennccee PPaaggeess   XXmmLLiissttSSeettBBoottttoommPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettBBoottttoommPPooss-A List function that makes a specified
          item the last visible item in the list

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

          vvooiidd XXmmLLiissttSSeettBBoottttoommPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettBBoottttoommPPooss makes the item at the specified position
          the last visible item in the List.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item to be made the
                 last visible item in the list.  A value of 1
                 indicates that the first item in the list is the last
                 visible item; a value of 2 indicates that the second
                 item is the last visible item; and so on.  A value of
                 0 indicates that the last item in the list is the
                 last visible item.


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

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





















     1-553                                            (printed 5/7/92)






     XXmmLLiissttSSeettHHoorriizzPPooss((33XX))    RReeffeerreennccee PPaaggeess    XXmmLLiissttSSeettHHoorriizzPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettHHoorriizzPPooss-A List function that scrolls to the
          specified position in the list

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

          vvooiidd XXmmLLiissttSSeettHHoorriizzPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettHHoorriizzPPooss sets the XXmmNNvvaalluuee resource of the
          horizontal ScrollBar to the specified position and updates
          the visible portion of the list with the new value if the
          List widget's XXmmNNlliissttSSiizzeePPoolliiccyy is set to XXmmCCOONNSSTTAANNTT or
          XXmmRREESSIIZZEE__IIFF__PPOOSSSSIIBBLLEE and the horizontal ScrollBar is
          currently visible.  This is equivalent to moving the
          horizontal ScrollBar to the specified position.


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

          _p_o_s_i_t_i_o_n
                 Specifies the horizontal position


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

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






















     1-554                                            (printed 5/7/92)






     XXmmLLiissttSSeettIItteemm((33XX))        RReeffeerreennccee PPaaggeess        XXmmLLiissttSSeettIItteemm((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettIItteemm-A List function that makes an existing item
          the first visible item in the list

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

          vvooiidd XXmmLLiissttSSeettIItteemm ((_w_i_d_g_e_t, _i_t_e_m))
               WWiiddggeett    _w_i_d_g_e_t;;
               XXmmSSttrriinngg  _i_t_e_m;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettIItteemm makes the first item in the list that matches
          _i_t_e_m the first visible item in the list.


          _w_i_d_g_e_t Specifies the ID of the List widget from whose list
                 an item is made the first visible

          _i_t_e_m   Specifies the item


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

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



























     1-555                                            (printed 5/7/92)






     XXmmLLiissttSSeettKKbbddIItteemmPPooss((33XX))  RReeffeerreennccee PPaaggeess  XXmmLLiissttSSeettKKbbddIItteemmPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettKKbbddIItteemmPPooss-A List function that sets the location
          cursor at a specified position

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

          BBoooolleeaann XXmmLLiissttSSeettKKbbddIItteemmPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettKKbbddIItteemmPPooss sets the location cursor at the item
          specified by _p_o_s_i_t_i_o_n.  This function does not determine if
          the item at the specified position is selected or not.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item at which the
                 location cursor is set.  A value of 1 indicates the
                 first item in the list; a value of 2 indicates the
                 second item; and so on.  A value of 0 sets the
                 location cursor at the last item in the list.


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

     RREETTUURRNN VVAALLUUEE
          Returns False if no item exists at the specified position or
          if the list is empty; otherwise, returns True.

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


















     1-556                                            (printed 5/7/92)






     XXmmLLiissttSSeettPPooss((33XX))         RReeffeerreennccee PPaaggeess         XXmmLLiissttSSeettPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttSSeettPPooss-A List function that makes the item at the
          given position the first visible position in the list

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

          vvooiidd XXmmLLiissttSSeettPPooss ((_w_i_d_g_e_t, _p_o_s_i_t_i_o_n))
               WWiiddggeett    _w_i_d_g_e_t;;
               iinntt       _p_o_s_i_t_i_o_n;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttSSeettPPooss makes the item at the given position the first
          visible position in the List.


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

          _p_o_s_i_t_i_o_n
                 Specifies the position of the item to be made the
                 first visible item in the list.  A value of 1
                 indicates that the first item in the list is the
                 first visible item; a value of 2 indicates that the
                 second item is the first visible item; and so on.  A
                 value of 0 indicates that the last item in the list
                 is the first visible item.


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

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





















     1-557                                            (printed 5/7/92)






     XXmmLLiissttUUppddaatteeSSeelleecctteeddLLiisstt((33RRXeXe)f)feerreennccee PPaaggXXememsLsLiissttUUppddaatteeSSeelleecctteeddLLiisstt((33XX))



     NNAAMMEE
          XXmmLLiissttUUppddaatteeSSeelleecctteeddLLiisstt-A List function that updates the
          XXmmNNsseelleecctteeddIItteemmss resource

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

          vvooiidd XXmmLLiissttUUppddaatteeSSeelleecctteeddLLiisstt ((_w_i_d_g_e_t))
               WWiiddggeett    _w_i_d_g_e_t;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttUUppddaatteeSSeelleecctteeddLLiisstt frees the contents of the current
          XXmmNNsseelleecctteeddIItteemmss list.  The routine traverses the XXmmNNiitteemmss
          list and adds each currently selected item to the
          XXmmNNsseelleecctteeddIItteemmss list.  For each selected item, there is a
          corresponding entry in the updated XXmmNNsseelleecctteeddIItteemmss list.


          _w_i_d_g_e_t    Specifies the ID of the List widget to update


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

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




























     1-558                                            (printed 5/7/92)






     XXmmLLiissttYYTTooPPooss((33XX))         RReeffeerreennccee PPaaggeess         XXmmLLiissttYYTTooPPooss((33XX))



     NNAAMMEE
          XXmmLLiissttYYTTooPPooss-A List function that returns the position of
          the item at a specified y coordinate

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

          iinntt XXmmLLiissttYYTTooPPooss ((_w_i_d_g_e_t, _y))
               WWiiddggeett    _w_i_d_g_e_t;;
               PPoossiittiioonn  _y;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmLLiissttYYTTooPPooss returns the position of the item at the given y
          coordinate within the list.


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

          _y      Specifies the y coordinate in the list's coordinate
                 system


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

     RREETTUURRNN VVAALLUUEE
          Returns the position of the item at the specified y
          coordinate.  A value of 1 indicates the first item in the
          list; a value of 2 indicates the second item; and so on.  A
          value of 0 indicates that no item exists at the specified y
          coordinate.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmLLiisstt((33XX)) and XXmmLLiissttPPoossTTooBBoouunnddss((33XX)).




















     1-559                                            (printed 5/7/92)






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



     NNAAMMEE
          XXmmMMaaiinnWWiinnddooww-The MainWindow widget class

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


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

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

          MainWindow can also create three Separator widgets that
          provide a visual separation of MainWindow's four components.
          The user can specify resources in a resource file for the
          automatically created gadgets that contain the MainWindow
          separators.  The name of the first separator gadget is
          "Separator1"; the second is "Separator2"; and the third is
          "Separator3".

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

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

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

        NNeeww RReessoouurrcceess
          The following table defines a set of widget resources used
          by the programmer to specify data.  The programmer can also
          set the resource values for the inherited classes to set



     1-560                                            (printed 5/7/92)






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



          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the XXmmNN or XXmmCC
          prefix and use the remaining letters.  To specify one of the
          defined values for a resource in a .Xdefaults file, remove
          the XXmm prefix and use the remaining letters (in either
          lowercase or uppercase, but include any underscores between
          words).  The codes in the access column indicate if the
          given resource can be set at creation time (C), set by using
          XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
          not applicable (N/A).

                                         XXmmMMaaiinnWWiinnddooww RReessoouurrccee SSeett
     NNaammee                        CCllaassss                       TTyyppee            DDeeffaauulltt            AAcccceessss
     _________________________________________________________________________________________________
     XmNcommandWindow            XmCCommandWindow            Widget          NULL               CSG
     XmNcommandWindowLocation    XmCCommandWindowLocation    unsigned char   ABOVE (SeeDesc.)   CG
     XmNmainWindowMarginHeight   XmCMainWindowMarginHeight   Dimension       0                  CSG
     XmNmainWindowMarginWidth    XmCMainWindowMarginWidth    Dimension       0                  CSG
     XmNmenuBar                  XmCMenuBar                  Widget          NULL               CSG
     XmNmessageWindow            XmCMessageWindow            Widget          NULL               CSG
     XmNshowSeparator            XmCShowSeparator            Boolean         False              CSG


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

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

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

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

          XXmmNNmmeennuuBBaarr
                    Specifies the widget to be laid out as the
                    MenuBar.  This widget must have been previously



     1-561                                            (printed 5/7/92)






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



                    created and managed as a child of MainWindow.

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

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


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

                                              XXmmSSccrroolllleeddWWiinnddooww RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                 AAcccceessss
     _______________________________________________________________________________________________________________
     XmNclipWindow                   XmCClipWindow                   Widget           dynamic                 G
     XmNhorizontalScrollBar          XmCHorizontalScrollBar          Widget           dynamic                 CSG
     XmNscrollBarDisplayPolicy       XmCScrollBarDisplayPolicy       unsigned char    dynamic                 CSG
     XmNscrollBarPlacement           XmCScrollBarPlacement           unsigned char    XmBOTTOM_RIGHT          CSG
     XmNscrolledWindowMarginHeight   XmCScrolledWindowMarginHeight   Dimension        0                       N/A
     XmNscrolledWindowMarginWidth    XmCScrolledWindowMarginWidth    Dimension        0                       N/A
     XmNscrollingPolicy              XmCScrollingPolicy              unsigned char    XmAPPLICATION_DEFINED   CG
     XmNspacing                      XmCSpacing                      Dimension        4                       CSG
     XmNtraverseObscuredCallback     XmCCallback                     XtCallbackList   NULL                    CSG
     XmNverticalScrollBar            XmCVerticalScrollBar            Widget           dynamic                 CSG
     XmNvisualPolicy                 XmCVisualPolicy                 unsigned char    dynamic                 G
     XmNworkWindow                   XmCWorkWindow                   Widget           NULL                    CSG

                                          XXmmMMaannaaggeerr RReessoouurrccee SSeett
     NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
     XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG







     1-562                                            (printed 5/7/92)






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



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

                             CCoommppoossiittee RReessoouurrccee SSeett
     NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
     ______________________________________________________________________
     XmNchildren         XmCReadOnly         WidgetList    NULL      G
     XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
     XmNnumChildren      XmCReadOnly         Cardinal      0         G

                                                   CCoorree RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
     XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
     XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
     XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
     XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
     XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
     XmNdepth                        XmCDepth                        int              dynamic                CG
     XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
     XmNheight                       XmCHeight                       Dimension        dynamic                CSG
     XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
     XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
     XmNscreen                       XmCScreen                       Screen *         dynamic                CG
     XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
     XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

        TTrraannssllaattiioonnss
          MainWindow inherits translations from ScrolledWindow.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)),
          XXmmCCrreeaatteeMMaaiinnWWiinnddooww((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp11((33XX)),
          XXmmMMaaiinnWWiinnddoowwSSeepp22((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp33((33XX)),
          XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX)), XXmmMMaannaaggeerr((33XX)), and
          XXmmSSccrroolllleeddWWiinnddooww((33XX))







     1-563                                            (printed 5/7/92)






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



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

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

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


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


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


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

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

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

























     1-564                                            (printed 5/7/92)






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



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

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

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


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

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


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

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

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


























     1-565                                            (printed 5/7/92)






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



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

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

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


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


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


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

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

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

























     1-566                                            (printed 5/7/92)






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



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

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

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


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

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


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

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

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

          _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r
                      Specifies the ScrollBar widget ID for the
                      horizontal ScrollBar to be associated with the
                      MainWindow widget.  Set this ID only after
                      creating an instance of the MainWindow widget.
                      The attribute name associated with this argument
                      is XXmmNNhhoorriizzoonnttaallSSccrroollllBBaarr.



     1-567                                            (printed 5/7/92)






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



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

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


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

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



































     1-568                                            (printed 5/7/92)






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



     NNAAMMEE
          XXmmMMaannaaggeerr-The Manager widget class

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


     DDEESSCCRRIIPPTTIIOONN
          Manager is a widget class used as a supporting superclass
          for other widget classes.  It supports the visual resources,
          graphics contexts, and traversal resources necessary for the
          graphics and traversal mechanisms.

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

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

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

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

                                          XXmmMMaannaaggeerr RReessoouurrccee SSeett
     NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
     XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG







     1-569                                            (printed 5/7/92)






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



     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
     XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
     XmNuserData             XmCUserData             XtPointer           NULL                   CSG

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

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

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

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

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

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

          XXmmNNiinniittiiaallFFooccuuss
                    Specifies the ID of a widget descendant of the
                    manager.  The widget must meet these conditions:


                      +o  The widget must be either a tab group or a
                         non-tab-group widget that can receive
                         keyboard focus.  For the definition of a tab
                         group, see the description of the Manager,
                         Primitive, and Gadget XXmmNNnnaavviiggaattiioonnTTyyppee
                         resources.  In general a widget can receive
                         keyboard focus when it is a primitive, a
                         gadget, or a manager (such as a DrawingArea
                         with no traversable children) that acts as a
                         primitive.

                      +o  The widget must not be a descendant of a tab



     1-570                                            (printed 5/7/92)






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



                         group that is itself a descendant of the
                         manager.  That is, the widget cannot be
                         contained within a tab group that is nested
                         inside the manager.

                      +o  The widget and its ancestors must have a
                         value of True for their XXmmNNttrraavveerrssaallOOnn
                         resources.


                    If the widget does not meet these conditions,
                    XXmmNNiinniittiiaallFFooccuuss is treated as if the value were
                    NULL.

                    This resource is meaningful only when the nearest
                    shell ancestor's XXmmNNkkeeyybbooaarrddFFooccuussPPoolliiccyy is
                    XXmmEEXXPPLLIICCIITT.  It is used to determine which widget
                    receives focus in these situations:


                      +o  When the manager is the child of a shell and
                         the shell hierarchy receives focus for the
                         first time

                      +o  When focus is inside the shell hierarchy, the
                         manager is a composite tab group, and the
                         user traverses to the manager via the
                         keyboard


                    Focus is then determined as follows:


                      +o  If XXmmNNiinniittiiaallFFooccuuss is a traversable non-tab-
                         group widget, that widget receives focus.

                      +o  If XXmmNNiinniittiiaallFFooccuuss is a traversable tab
                         group, that tab group receives focus.  If
                         that tab group is a composite with descendant
                         tab groups or traversable non-tab-group
                         widgets, these procedures are used
                         recursively to assign focus to a descendant
                         of that tab group.

                      +o  If XXmmNNiinniittiiaallFFooccuuss is NULL, the first
                         traversable non-tab-group widget that is not
                         contained within a nested tab group receives
                         focus.

                      +o  If XXmmNNiinniittiiaallFFooccuuss is NULL and no traversable
                         non-tab-group widget exists, the first
                         traversable tab group that is not contained



     1-571                                            (printed 5/7/92)






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



                         within a nested tab group receives focus.  If
                         that tab group is a composite with descendant
                         tab groups or traversable non-tab-group
                         widgets, these procedures are used
                         recursively to assign focus to a descendant
                         of that tab group.


                    If a shell hierarchy regains focus after losing
                    it, focus returns to the widget that had the focus
                    at the time it left the hierarchy.

                    The use of XXmmNNiinniittiiaallFFooccuuss is undefined if the
                    manager is a MenuBar, PulldownMenu, PopupMenu, or
                    OptionMenu.

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


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

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

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

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

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

                         When any widget in a hierarchy has an
                         XXmmNNnnaavviiggaattiioonnTTyyppee of XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP,
                         traversal of tab groups in the hierarchy
                         proceeds to widgets in the order in which
                         their XXmmNNnnaavviiggaattiioonnTTyyppee resources were
                         specified as XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP or
                         XXmmSSTTIICCKKYY__TTAABB__GGRROOUUPP, whether by creating the
                         widgets with that value, by calling



     1-572                                            (printed 5/7/92)






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



                         XXttSSeettVVaalluueess, or by calling XXmmAAddddTTaabbGGrroouupp.


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

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

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

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

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

          XXmmNNuunniittTTyyppee
                    Provides the basic support for resolution
                    independence.  It defines the type of units a
                    widget uses with sizing and positioning resources.
                    If the widget's parent is a subclass of XXmmMMaannaaggeerr
                    and if the XXmmNNuunniittTTyyppee resource is not explicitly
                    set, it defaults to the unit type of the parent
                    widget.  If the widget's parent is not a subclass
                    of XXmmMMaannaaggeerr, the resource has a default unit type
                    of XXmmPPIIXXEELLSS.

                    XXmmNNuunniittTTyyppee can have the following values:


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







     1-573                                            (printed 5/7/92)






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



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

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

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

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


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


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

          Colors are generated only at creation.  Resetting the
          background through XXttSSeettVVaalluueess does not regenerate the other
          colors.  XXmmCChhaannggeeCCoolloorr can be used to recalculate all
          associated colors based on a new background color.

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

                             CCoommppoossiittee RReessoouurrccee SSeett






     1-574                                            (printed 5/7/92)






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



     NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
     ______________________________________________________________________
     XmNchildren         XmCReadOnly         WidgetList    NULL      G
     XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
     XmNnumChildren      XmCReadOnly         Cardinal      0         G

                                                   CCoorree RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
     XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
     XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
     XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
     XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
     XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
     XmNdepth                        XmCDepth                        int              dynamic                CG
     XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
     XmNheight                       XmCHeight                       Dimension        dynamic                CSG
     XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
     XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
     XmNscreen                       XmCScreen                       Screen *         dynamic                CG
     XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
     XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

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

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


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

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


        TTrraannssllaattiioonnss
          The following set of translations are used by Manager
          widgets that have Gadget children.  Since Gadgets cannot
          have translations associated with them, it is the
          responsibility of the Manager widget to intercept the events
          of interest and pass them to any Gadget child with focus.



     1-575                                            (printed 5/7/92)






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



          These events are ignored if no Gadget child has the focus.
          These translations may not directly correspond to a
          translation table.

          BBAAnnyy MMoottiioonn::   MMaannaaggeerrGGaaddggeettBBuuttttoonnMMoottiioonn(())
          BBSSeelleecctt PPrreessss:: MMaannaaggeerrGGaaddggeettAArrmm(())
          BBSSeelleecctt CClliicckk:: MMaannaaggeerrGGaaddggeettAAccttiivvaattee(())
          BBSSeelleecctt RReelleeaassee::MMaannaaggeerrGGaaddggeettAAccttiivvaattee(())
          BBSSeelleecctt PPrreessss 22++::MMaannaaggeerrGGaaddggeettMMuullttiiAArrmm(())
          BBSSeelleecctt RReelleeaassee 22++::MMaannaaggeerrGGaaddggeettMMuullttiiAAccttiivvaattee(())
          BBDDrraagg PPrreessss::   MMaannaaggeerrGGaaddggeettDDrraagg(())

          KKSSeelleecctt::       MMaannaaggeerrGGaaddggeettSSeelleecctt(())
          KKAAccttiivvaattee::     MMaannaaggeerrPPaarreennttAAccttiivvaattee(())

          KKCCaanncceell::       MMaannaaggeerrPPaarreennttCCaanncceell(())

          KKPPrreevvFFiieelldd::    MMaannaaggeerrGGaaddggeettPPrreevvTTaabbGGrroouupp(())
          KKNNeexxttFFiieelldd::    MMaannaaggeerrGGaaddggeettNNeexxttTTaabbGGrroouupp(())

          KKUUpp::           MMaannaaggeerrGGaaddggeettTTrraavveerrsseeUUpp(())
          KKDDoowwnn::         MMaannaaggeerrGGaaddggeettTTrraavveerrsseeDDoowwnn(())
          KKLLeefftt::         MMaannaaggeerrGGaaddggeettTTrraavveerrsseeLLeefftt(())
          KKRRiigghhtt::        MMaannaaggeerrGGaaddggeettTTrraavveerrsseeRRiigghhtt(())

          KKBBeeggiinnLLiinnee::    MMaannaaggeerrGGaaddggeettTTrraavveerrsseeHHoommee(())

          KKHHeellpp::         MMaannaaggeerrGGaaddggeettHHeellpp(())

          KKAAnnyy::          MMaannaaggeerrGGaaddggeettKKeeyyIInnppuutt(())


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


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

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

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

          MMaannaaggeerrGGaaddggeettDDrraagg(()):
                    Drags the contents of a gadget label, identified
                    by pressing BBDDrraagg.  This action creates a
                    DragContext object whose XXmmNNeexxppoorrttTTaarrggeettss resource
                    is set to "COMPOUND_TEXT" for a label type of
                    XXmmSSTTRRIINNGG; otherwise, "PIXMAP" if the label type is



     1-576                                            (printed 5/7/92)






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



                    XXmmPPIIXXMMAAPP.  This action is undefined for gadgets
                    used in a menu system.

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

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

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

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

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

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

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

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

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

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




     1-577                                            (printed 5/7/92)






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



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

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

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

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

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

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


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


          <<FFooccuussIInn>>:
                    If the shell's keyboard focus policy is XXmmEEXXPPLLIICCIITT
                    and the event occurs in a gadget, causes the
                    gadget to be highlighted and to take the focus.

          <<FFooccuussOOuutt>>:
                    If the shell's keyboard focus policy is XXmmEEXXPPLLIICCIITT
                    and the event occurs in a gadget, causes the
                    gadget to be unhighlighted and to lose the focus.


        VViirrttuuaall BBiinnddiinnggss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VViirrttuuaallBBiinnddiinnggss((33XX)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmCChhaannggeeCCoolloorr((33XX)),
          XXmmGGaaddggeett((33XX)), and XXmmSSccrreeeenn((33XX)).



     1-578                                            (printed 5/7/92)






     XXmmMMaappSSeeggmmeennttEEnnccooddiinngg((33XX)) RReeffeerreennccee PPaaggeess XXmmMMaappSSeeggmmeennttEEnnccooddiinngg((33XX))



     NNAAMMEE
          XXmmMMaappSSeeggmmeennttEEnnccooddiinngg-A compound string function that returns
          the compound text encoding format associated with the
          specified font list tag

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

          cchhaarr ** XXmmMMaappSSeeggmmeennttEEnnccooddiinngg ((_f_o_n_t_l_i_s_t__t_a_g))
               cchhaarr        **_f_o_n_t_l_i_s_t__t_a_g;;


     DDEESSCCRRIIPPTTIIOONN
          XXmmMMaappSSeeggmmeennttEEnnccooddiinngg searches the segment encoding registry
          for an entry that matches the specified font list tag and
          returns a copy of the associated compound text encoding
          format.  The application is responsible for freeing the
          storage associated with the returned data by calling XXttFFrreeee.


          _f_o_n_t_l_i_s_t__t_a_g
                 Specifies the compound string font list tag


     RREETTUURRNN VVAALLUUEE
          Returns a copy of the associated compound text encoding
          format if the font list tag is found in the registry;
          otherwise, returns NULL.

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          XXmmCCvvttXXmmSSttrriinnggTTooCCTT((33XX)), XXmmFFoonnttLLiisstt((33XX)),
          XXmmRReeggiisstteerrSSeeggmmeennttEEnnccooddiinngg((33XX)), and XXmmSSttrriinngg((33XX)).























     1-579                                            (printed 5/7/92)






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



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

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

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


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


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

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


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

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























     1-580                                            (printed 5/7/92)






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



     NNAAMMEE
          XXmmMMeennuuSShheellll-The MenuShell widget class

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


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

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


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

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

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

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


          Setting XXmmNNhheeiigghhtt, XXmmNNwwiiddtthh, or XXmmNNbboorrddeerrWWiiddtthh for either a
          MenuShell or its child sets that resource to the same value
          in both the parent and the child.  An application should
          always specify these resources for the child, not the
          parent.

          For the managed child of a MenuShell, regardless of the
          value of the shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or
          XXmmNNyy sets the corresponding resource of the parent but does
          not change the child's position relative to the parent.



     1-581                                            (printed 5/7/92)






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



          XXttGGeettVVaalluueess for the child's XXmmNNxx or XXmmNNyy yields the value of
          the corresponding resource in the parent.  The _x and _y
          coordinates of the child's upper left outside corner
          relative to the parent's upper left inside corner are both
          zero minus the value of XXmmNNbboorrddeerrWWiiddtthh.

        CCllaasssseess
          MenuShell inherits behavior and resources from CCoorree,
          CCoommppoossiittee, SShheellll, and OOvveerrrriiddeeSShheellll classes.

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

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

        NNeeww RReessoouurrcceess
          MenuShell overrides the XXmmNNaalllloowwSShheellllRReessiizzee resource in
          Shell.  The following table defines a set of widget
          resources used by the programmer to specify data.  The
          programmer can also set the resource values for the
          inherited classes to set attributes for this widget.  To
          reference a resource by name or by class in a .Xdefaults
          file, remove the XXmmNN or XXmmCC prefix and use the remaining
          letters.  To specify one of the defined values for a
          resource in a .Xdefaults file, remove the XXmm prefix and use
          the remaining letters (in either lowercase or uppercase, but
          include any underscores between words).  The codes in the
          access column indicate if the given resource can be set at
          creation time (C), set by using XXttSSeettVVaalluueess (S), retrieved
          by using XXttGGeettVVaalluueess (G), or is not applicable (N/A).

                            XXmmMMeennuuSShheellll RReessoouurrccee SSeett
     NNaammee                 CCllaassss                TTyyppee         DDeeffaauulltt   AAcccceessss
     _______________________________________________________________________
     XmNbuttonFontList    XmCButtonFontList    XmFontList   dynamic   CSG
     XmNdefaultFontList   XmCDefaultFontList   XmFontList   dynamic   CG
     XmNlabelFontList     XmCLabelFontList     XmFontList   dynamic   CSG


          XXmmNNbbuuttttoonnFFoonnttLLiisstt
                    Specifies the font list used for MenuShell's
                    button descendants.  If this value is NULL at
                    initialization and if the value of
                    XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL, XXmmNNbbuuttttoonnFFoonnttLLiisstt
                    is initialized to the value of XXmmNNddeeffaauullttFFoonnttLLiisstt.
                    If the value of XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL,
                    XXmmNNbbuuttttoonnFFoonnttLLiisstt is initialized by looking up the
                    parent hierarchy of the widget for an ancestor
                    that is a subclass of the XmBulletinBoard,
                    VendorShell, or XmMenuShell widget class.  If such
                    an ancestor is found, XXmmNNbbuuttttoonnFFoonnttLLiisstt is
                    initialized to the XXmmNNbbuuttttoonnFFoonnttLLiisstt of the
                    ancestor  widget.  If no such ancestor is found,



     1-582                                            (printed 5/7/92)






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



                    the default is implementation dependent.

          XXmmNNddeeffaauullttFFoonnttLLiisstt
                    Specifies a default font list for MenuShell's
                    descendants.  This resource is obsolete and exists
                    for compatibility with earlier releases.  It has
                    been replaced by XXmmNNbbuuttttoonnFFoonnttLLiisstt and
                    XXmmNNllaabbeellFFoonnttLLiisstt.

          XXmmNNllaabbeellFFoonnttLLiisstt
                    Specifies the font list used for MenuShell's label
                    descendants (Labels and LabelGadgets).  If this
                    value is NULL at initialization and if the value
                    of XXmmNNddeeffaauullttFFoonnttLLiisstt is not NULL,
                    XXmmNNllaabbeellFFoonnttLLiisstt is initialized to the value of
                    XXmmNNddeeffaauullttFFoonnttLLiisstt.  If the value of
                    XXmmNNddeeffaauullttFFoonnttLLiisstt is NULL, XXmmNNllaabbeellFFoonnttLLiisstt is
                    initialized by looking up the parent hierarchy of
                    the widget for an ancestor that is a subclass of
                    the XmBulletinBoard, VendorShell, or XmMenuShell
                    widget class.  If such an ancestor is found,
                    XXmmNNllaabbeellFFoonnttLLiisstt is initialized to the
                    XXmmNNllaabbeellFFoonnttLLiisstt of the ancestor widget.  If no
                    such ancestor is found, the default is
                    implementation dependent.


        IInnhheerriitteedd RReessoouurrcceess
          MenuShell inherits behavior and resources from the following
          superclasses.  For a complete description of each resource,
          refer to the man page for that superclass.  The following
          tables define a set of widget resources used by the
          programmer to specify data.  The programmer can set the
          resource values for these inherited classes to set
          attributes for this widget.  To reference a resource by name
          or by class in a .Xdefaults file, remove the XXmmNN or XXmmCC
          prefix and use the remaining letters.  To specify one of the
          defined values for a resource in a .Xdefaults file, remove
          the XXmm prefix and use the remaining letters (in either
          lowercase or uppercase, but include any underscores between
          words).  The codes in the access column indicate if the
          given resource can be set at creation time (C), set by using
          XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
          not applicable (N/A).

                                              SShheellll RReessoouurrccee SSeett
     NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
     ____________________________________________________________________________________________________







     1-583                                            (printed 5/7/92)






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



     XmNallowShellResize       XmCAllowShellResize       Boolean                  True             G
     XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
     XmNgeometry               XmCGeometry               String                   NULL             CSG
     XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  True             CSG
     XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
     XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
     XmNsaveUnder              XmCSaveUnder              Boolean                  True             CSG
     XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG

                             CCoommppoossiittee RReessoouurrccee SSeett
     NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
     ______________________________________________________________________
     XmNchildren         XmCReadOnly         WidgetList    NULL      G
     XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
     XmNnumChildren      XmCReadOnly         Cardinal      0         G

                                                   CCoorree RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
     XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
     XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
     XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
     XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
     XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
     XmNdepth                        XmCDepth                        int              dynamic                CG
     XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
     XmNheight                       XmCHeight                       Dimension        dynamic                CSG
     XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
     XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
     XmNscreen                       XmCScreen                       Screen *         dynamic                CG
     XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
     XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

        TTrraannssllaattiioonnss
          The XmMenuShell translations are listed below.  These
          translations may not directly correspond to a translation
          table.

          BBSSeelleecctt PPrreessss:: CClleeaarrTTrraavveerrssaall(())
          BBSSeelleecctt RReelleeaassee::MMeennuuSShheellllPPooppddoowwnnDDoonnee(())


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





     1-584                                            (printed 5/7/92)






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



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

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

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

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


        VViirrttuuaall BBiinnddiinnggss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VViirrttuuaallBBiinnddiinnggss((33XX)).

     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)), CCoorree((33XX)), OOvveerrrriiddeeSShheellll((33XX)), SShheellll((33XX)),
          XXmmCCrreeaatteeMMeennuuSShheellll((33XX)), XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)),
          XXmmCCrreeaatteePPuullllddoowwnn((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).




















     1-585                                            (printed 5/7/92)






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



     NNAAMMEE
          XXmmMMeessssaaggeeBBooxx-The MessageBox widget class

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


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

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

          The default value for XXmmNNiinniittiiaallFFooccuuss is the value of
          XXmmNNddeeffaauullttBBuuttttoonn.

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

          The user can specify resources in a resource file for the
          gadgets created automatically that contain the MessageBox
          symbol pixmap and separator.  The gadget names are "Symbol"
          and "Separator".

          A MessageBox can also be customized by creating and managing
          new children that are added to the MessageBox children
          created automatically by the convenience dialogs.  In the
          case of TemplateDialog, only the separator child is created
          by default.  If the callback, string, or pixmap symbol
          resources are specified, the appropriate child will be
          created.

          Additional children are laid out in the following manner:


            +o  The first MenuBar child is placed at the top of the
               window.

            +o  All XXmmPPuusshhBBuuttttoonn widgets or gadgets, and their
               subclasses are placed after the OOKK button in the order
               of their creation.



     1-586                                            (printed 5/7/92)






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



            +o  A child that is not in the above categories is placed
               above the row of buttons.  If a message label exists,
               the child is placed below the label.  If a message
               pixmap exists, but a message label is absent, the child
               is placed on the same row as the pixmap.  The child
               behaves as a work area and grows or shrinks to fill the
               space above the row of buttons.  The layout of multiple
               work area children is undefined.


          At initialization, MessageBox looks for the following bitmap
          files:


            +o  xm_error

            +o  xm_information

            +o  xm_question

            +o  xm_working

            +o  xm_warning


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

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

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

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

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

                                       XXmmMMeessssaaggeeBBooxx RReessoouurrccee SSeett



     1-587                                            (printed 5/7/92)






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



     NNaammee                   CCllaassss                  TTyyppee             DDeeffaauulltt                 AAcccceessss
     _____________________________________________________________________________________________
     XmNcancelCallback      XmCCallback            XtCallbackList   NULL                    C
     XmNcancelLabelString   XmCCancelLabelString   XmString         dynamic                 CSG
     XmNdefaultButtonType   XmCDefaultButtonType   unsigned char    XmDIALOG_OK_BUTTON      CSG
     XmNdialogType          XmCDialogType          unsigned char    XmDIALOG_MESSAGE        CSG
     XmNhelpLabelString     XmCHelpLabelString     XmString         dynamic                 CSG
     XmNmessageAlignment    XmCAlignment           unsigned char    XmALIGNMENT_BEGINNING   CSG
     XmNmessageString       XmCMessageString       XmString         ""                      CSG
     XmNminimizeButtons     XmCMinimizeButtons     Boolean          False                   CSG
     XmNokCallback          XmCCallback            XtCallbackList   NULL                    C
     XmNokLabelString       XmCOkLabelString       XmString         dynamic                 CSG
     XmNsymbolPixmap        XmCPixmap              Pixmap           dynamic                 CSG


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

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

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


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

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

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

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


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


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

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



     1-588                                            (printed 5/7/92)






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



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

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

                      +o  XXmmDDIIAALLOOGG__TTEEMMPPLLAATTEE-indicates a TemplateDialog.
                         The TemplateDialog contains only a separator
                         child.  It does not have an associated
                         message symbol.

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

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


                    If this resource is changed via XXttSSeettVVaalluueess, the
                    symbol bitmap is modified to the new XXmmNNddiiaallooggTTyyppee
                    bitmap unless XXmmNNssyymmbboollPPiixxmmaapp is also being set in
                    the call to XXttSSeettVVaalluueess.  If the dialog type does
                    not have an associated message symbol, then no
                    bitmap will be displayed.

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

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


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

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

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


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

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

          XXmmNNookkCCaallllbbaacckk
                    Specifies the list of callbacks that is called



     1-589                                            (printed 5/7/92)






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



                    when the user clicks on the OK button.  The reason
                    sent by the callback is XXmmCCRR__OOKK.

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

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


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

                                XXmmBBuulllleettiinnBBooaarrdd RReessoouurrccee SSeett
     NNaammee                  CCllaassss                TTyyppee             DDeeffaauulltt         AAcccceessss
     __________________________________________________________________________________
     XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
     XmNautoUnmanage       XmCAutoUnmanage      Boolean          True            CG
     XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         CSG
     XmNcancelButton       XmCWidget            Widget           Cancel button   SG
     XmNdefaultButton      XmCWidget            Widget           dynamic         SG
     XmNdefaultPosition    XmCDefaultPosition   Boolean          True            CSG
     XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
     XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
     XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
     XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
     XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
     XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG
     XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
     XmNnoResize           XmCNoResize          Boolean          False           CSG
     XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY    CSG
     XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
     XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
     XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
     XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C

                                          XXmmMMaannaaggeerr RReessoouurrccee SSeett
     NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
     _________________________________________________________________________________________________
     XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
     XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
     XmNforeground           XmCForeground           Pixel               dynamic                CSG
     XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C







     1-590                                            (printed 5/7/92)






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



     XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
     XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
     XmNinitialFocus         XmCInitialFocus         Widget              dynamic                CSG
     XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
     XmNshadowThickness      XmCShadowThickness      Dimension           dynamic                CSG
     XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
     XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
     XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
     XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
     XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
     XmNuserData             XmCUserData             XtPointer           NULL                   CSG

                             CCoommppoossiittee RReessoouurrccee SSeett
     NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
     ______________________________________________________________________
     XmNchildren         XmCReadOnly         WidgetList    NULL      G
     XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
     XmNnumChildren      XmCReadOnly         Cardinal      0         G

                                                   CCoorree RReessoouurrccee SSeett
     NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
     ______________________________________________________________________________________________________________
     XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                N/A
     XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
     XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
     XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
     XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
     XmNborderWidth                  XmCBorderWidth                  Dimension        0                      CSG
     XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
     XmNdepth                        XmCDepth                        int              dynamic                CG
     XmNdestroyCallback              XmCCallback                     XtCallbackList   NULL                   C
     XmNheight                       XmCHeight                       Dimension        dynamic                CSG
     XmNinitialResourcesPersistent   XmCInitialResourcesPersistent   Boolean          True                   C
     XmNmappedWhenManaged            XmCMappedWhenManaged            Boolean          True                   CSG
     XmNscreen                       XmCScreen                       Screen *         dynamic                CG
     XmNsensitive                    XmCSensitive                    Boolean          True                   CSG
     XmNtranslations                 XmCTranslations                 XtTranslations   dynamic                CSG
     XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
     XmNx                            XmCPosition                     Position         0                      CSG
     XmNy                            XmCPosition                     Position         0                      CSG

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

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




     1-591                                            (printed 5/7/92)






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



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

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


        TTrraannssllaattiioonnss
          XmMessageBox includes the translations from XmManager.

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


          MMAAnnyy KKCCaanncceell:
                    Calls the activate callbacks for the cancel button
                    if it is sensitive.

          KKAAccttiivvaattee:
                    Calls the activate callbacks for the button with
                    the keyboard focus.  If no button has the keyboard
                    focus, calls the activate callbacks for the
                    default button if it is sensitive.

          <<OOkk BBuuttttoonn AAccttiivvaatteedd>>:
                    Calls the callbacks for XXmmNNookkCCaallllbbaacckk.

          <<CCaanncceell BBuuttttoonn AAccttiivvaatteedd>>:
                    Calls the callbacks for XXmmNNccaanncceellCCaallllbbaacckk.

          <<HHeellpp BBuuttttoonn AAccttiivvaatteedd>>:
                    Calls the callbacks for XXmmNNhheellppCCaallllbbaacckk.

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

          <<MMaapp>>:    Calls the callbacks for XXmmNNmmaappCCaallllbbaacckk if the
                    parent is a DialogShell.

          <<UUnnmmaapp>>:  Calls the callbacks for XXmmNNuunnmmaappCCaallllbbaacckk if the
                    parent is a DialogShell.


        VViirrttuuaall BBiinnddiinnggss
          The bindings for virtual keys are vendor specific.  For
          information about bindings for virtual buttons and keys, see
          VViirrttuuaallBBiinnddiinnggss((33XX)).









     1-592                                            (printed 5/7/92)






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



     RREELLAATTEEDD IINNFFOORRMMAATTIIOONN
          CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)),
          XXmmBBuulllleettiinnBBooaarrdd((33XX)), XXmmCCrreeaatteeEErrrroorrDDiiaalloogg((33XX)),
          XXmmCCrreeaatteeIInnffoorrmmaattiioonnDDiiaalloogg((33XX)), XXmmCCrreeaatteeMMeessssaaggeeBBooxx((33XX)),
          XXmmCCrreeaatteeMMeessssaaggeeDDiiaalloogg((33XX)), XXmmCCrreeaatteeQQuueessttiioonnDDiiaalloogg((33XX)),
          XXmmCCrreeaatteeTTeemmppllaatteeDDiiaalloogg((33XX)), XXmmCCrreeaatteeWWaarrnniinnggDDiiaalloogg((33XX)),
          XXmmCCrreeaatteeWWoorrkkiinnggDDiiaalloogg((33XX)), XXmmMMaannaaggeerr((33XX)), and
          XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd((33XX)).















































     1-593                                            (printed 5/7/92)






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



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

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

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


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


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

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


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

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

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

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

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

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

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


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

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

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





     1-594                                            (printed 5/7/92)






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



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

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

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


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

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

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


            +o

            +o  Option Menu Label Gadget-"OptionLabel"

            +o  Option Menu Cascade Button-"OptionButton"


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


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

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

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




     1-595                                            (printed 5/7/92)






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



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

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

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


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

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

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


            +o

            +o  Option Menu Label Gadget-"OptionLabel"

            +o  Option Menu Cascade Button-"OptionButton"


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


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

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

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




     1-596                                            (printed 5/7/92)



 o
