


                                                     XmListDeleteAllItems(3X)



   NAME
     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

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

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

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



































   1-459






   XmListDeleteItem(3X)



   NAME
     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

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

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

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

































   1-460






                                                        XmListDeleteItems(3X)



   NAME
     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

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

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

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



























   1-461






   XmListDeleteItemsPos(3X)



   NAME
     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

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

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

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























   1-462






                                                          XmListDeletePos(3X)



   NAME
     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

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

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

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




























   1-463






   XmListDeletePositions(3X)



   NAME
     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

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

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

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






















   1-464






                                                   XmListDeselectAllItems(3X)



   NAME
     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

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

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

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


































   1-465






   XmListDeselectItem(3X)



   NAME
     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

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

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

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































   1-466






                                                        XmListDeselectPos(3X)



   NAME
     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

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

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

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



























   1-467






   XmListGetKbdItemPos(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns the position of the current keyboard item.  A value of 1 indi-
     cates 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.

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





























   1-468






                                                        XmListGetMatchPos(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns TRUE if the specified item is present in the list, and FALSE if
     it is not.

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
















   1-469






   XmListGetSelectedPos(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns TRUE if the list has any selected items, and FALSE if it does
     not.

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



















   1-470






                                                         XmListItemExists(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns True if the specified item is present in the list.

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





























   1-471






   XmListItemPos(3X)



   NAME
     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

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

   DESCRIPTION
     XXmmLLiissttIItteemmPPooss returns the position of the first instance of the speci-
     fied 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)).

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

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


























   1-472






                                                        XmListPosSelected(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns True if the list item is selected; otherwise, returns False if
     the item is not selected or the specified position is invalid.

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

























   1-473






   XmListPosToBounds(3X)



   NAME
     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

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

   DESCRIPTION
     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 rela-
     tive 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 indi-
            cates 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)).

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

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






                                                       XmListReplaceItems(3X)



   NAME
     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

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

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

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














   1-475






   XmListReplaceItemsPos(3X)



   NAME
     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 ele-
     ments in the list

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

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

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










   1-476






                                          XmListReplaceItemsPosUnselected(3X)



   NAME
     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

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

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

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












   1-477






   XmListReplaceItemsUnselected(3X)



   NAME
     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

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

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

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
















   1-478






                                                   XmListReplacePositions(3X)



   NAME
     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

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

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

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















   1-479






   XmListSelectItem(3X)



   NAME
     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

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

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

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


























   1-480






                                                          XmListSelectPos(3X)



   NAME
     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

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

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

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






















   1-481






   XmListSetAddMode(3X)



   NAME
     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

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

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

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































   1-482






                                                      XmListSetBottomItem(3X)



   NAME
     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

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

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

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































   1-483






   XmListSetBottomPos(3X)



   NAME
     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

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

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

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


























   1-484






                                                        XmListSetHorizPos(3X)



   NAME
     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

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

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

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



























   1-485






   XmListSetItem(3X)



   NAME
     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

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

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

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































   1-486






                                                      XmListSetKbdItemPos(3X)



   NAME
     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

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

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

   RETURN VALUE
     Returns False if no item exists at the specified position or if the list
     is empty; otherwise, returns True.

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























   1-487






   XmListSetPos(3X)



   NAME
     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

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

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

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


























   1-488






                                                 XmListUpdateSelectedList(3X)



   NAME
     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I--
     tteemmss resource

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

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

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
































   1-489






   XmListYToPos(3X)



   NAME
     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

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

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

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

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






                                                             XmMainWindow(3X)



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

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

   DESCRIPTION
     MainWindow provides a standard layout for the primary window of an
     application.  This layout includes a MenuBar, a CommandWindow, a work
     region, a MessageWindow, and ScrollBars.  Any or all of these areas are
     optional.  The work region and ScrollBars in the MainWindow behave
     identically to the work region and ScrollBars in the ScrolledWindow
     widget.  The user can think of the MainWindow as an extended Scrol-
     ledWindow with an optional MenuBar and optional CommandWindow and Mes-
     sageWindow.

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

     MainWindow can also create three Separator widgets that provide a visual
     separation of MainWindow's four components.  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".

     Classes

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

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

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

     New Resources

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


   1-491






   XmMainWindow(3X)


     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 MainWin-
               dow.  This resource overrides any setting of the ScrolledWin-
               dow resource XXmmNNssccrroolllleeddWWiinnddoowwMMaarrggiinnHHeeiigghhtt.

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

     XXmmNNmmeennuuBBaarr
               Specifies the widget to be laid out as the MenuBar.  This
               widget must have been previously created and managed as a
               child of MainWindow.

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

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




   1-492






                                                             XmMainWindow(3X)


     Inherited Resources

     MainWindow inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                                            XXmmSSccrroolllleeddWWiinnddooww RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                 AAcccceessss
   _______________________________________________________________________________________________________________
   XmNclipWindow                   XmCClipWindow                   Widget           dynamic                 G
   XmNhorizontalScrollBar          XmCHorizontalScrollBar          Widget           dynamic                 CSG
   XmNscrollBarDisplayPolicy       XmCScrollBarDisplayPolicy       unsigned char    dynamic                 CSG
   XmNscrollBarPlacement           XmCScrollBarPlacement           unsigned char    XmBOTTOM_RIGHT          CSG
   XmNscrolledWindowMarginHeight   XmCScrolledWindowMarginHeight   Dimension        0                       N/A
   XmNscrolledWindowMarginWidth    XmCScrolledWindowMarginWidth    Dimension        0                       N/A
   XmNscrollingPolicy              XmCScrollingPolicy              unsigned char    XmAPPLICATION_DEFINED   CG
   XmNspacing                      XmCSpacing                      Dimension        4                       CSG
   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
   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


   1-493






   XmMainWindow(3X)


   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

     Translations

     MainWindow inherits translations from ScrolledWindow.

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmCCrreeaatteeMMaaiinnWWiinnddooww((33XX)),
     XXmmMMaaiinnWWiinnddoowwSSeepp11((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp22((33XX)), XXmmMMaaiinnWWiinnddoowwSSeepp33((33XX)),
     XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass((33XX)), XXmmMMaannaaggeerr((33XX)), and XXmmSSccrroolllleeddWWiinnddooww((33XX))



































   1-494






                                                         XmMainWindowSep1(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp11 ((_w_i_d_g_e_t))
          WWiiddggeett    _w_i_d_g_e_t;;

   DESCRIPTION
     XXmmMMaaiinnWWiinnddoowwSSeepp11 returns the widget ID of the first Separator widget in
     the MainWindow.  The first Separator widget is located between the Menu-
     Bar and the Command widget.  This Separator is visible only when
     XXmmNNsshhoowwSSeeppaarraattoorr is True.

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

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

   RETURN VALUE
     Returns the widget ID of the first Separator.

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






























   1-495






   XmMainWindowSep2(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp22 ((_w_i_d_g_e_t))
          WWiiddggeett           _w_i_d_g_e_t;;

   DESCRIPTION
     XXmmMMaaiinnWWiinnddoowwSSeepp22 returns the widget ID of the second Separator widget in
     the MainWindow.  The second Separator widget is located between the Com-
     mand widget and the ScrolledWindow.  This Separator is visible only when
     XXmmNNsshhoowwSSeeppaarraattoorr is True.

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

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

   RETURN VALUE
     Returns the widget ID of the second Separator.

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






























   1-496






                                                         XmMainWindowSep3(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     WWiiddggeett XXmmMMaaiinnWWiinnddoowwSSeepp33 ((_w_i_d_g_e_t))
          WWiiddggeett           _w_i_d_g_e_t;;

   DESCRIPTION
     XXmmMMaaiinnWWiinnddoowwSSeepp33 returns the widget ID of the third Separator widget in
     the MainWindow.  The third Separator widget is located between the mes-
     sage window and the widget above it.  This Separator is visible only
     when XXmmNNsshhoowwSSeeppaarraattoorr is True.

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

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

   RETURN VALUE
     Returns the widget ID of the third Separator.

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






























   1-497






   XmMainWindowSetAreas(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMaaiinnWW..hh>>
     vvooiidd XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass ((_w_i_d_g_e_t, _m_e_n_u__b_a_r, _c_o_m_m_a_n_d__w_i_n_d_o_w,
               _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r, _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r, _w_o_r_k__r_e_g_i_o_n))
          WWiiddggeett    _w_i_d_g_e_t;;
          WWiiddggeett    _m_e_n_u__b_a_r;;
          WWiiddggeett    _c_o_m_m_a_n_d__w_i_n_d_o_w;;
          WWiiddggeett    _h_o_r_i_z_o_n_t_a_l__s_c_r_o_l_l_b_a_r;;
          WWiiddggeett    _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r;;
          WWiiddggeett    _w_o_r_k__r_e_g_i_o_n;;

   DESCRIPTION
     XXmmMMaaiinnWWiinnddoowwSSeettAArreeaass identifies which of the valid children for each
     area (such as the MenuBar and work region) are to be actively managed by
     MainWindow.  This function also sets up or adds the MenuBar, work win-
     dow, command window, and ScrollBar widgets to the application's main
     window widget.

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

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

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

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

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

     _v_e_r_t_i_c_a_l__s_c_r_o_l_l_b_a_r
                 Specifies the ScrollBar widget ID for the vertical ScrollBar
                 to be associated with the MainWindow widget.  Set this ID
                 only after creating an instance of the MainWindow widget.
                 The attribute name associated with this argument is XXmmNNvveerr--
                 t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


   1-498






                                                     XmMainWindowSetAreas(3X)


                 with the MainWindow widget.  Set this ID only after creating
                 an instance of the MainWindow widget.  The attribute name
                 associated with this argument is XXmmNNwwoorrkkWWiinnddooww.

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

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















































   1-499






   XmManager(3X)



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

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

   DESCRIPTION
     Manager is a widget class used as a supporting superclass for other
     widget classes.  It supports the visual resources, graphics contexts,
     and traversal resources necessary for the graphics and traversal mechan-
     isms.

     Classes

     Manager inherits behavior and resources from CCoorree, CCoommppoossiittee, and CCoonn--
     ssttrraaiinntt classes.

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

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

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                        XXmmMMaannaaggeerr RReessoouurrccee SSeett
   NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
   _________________________________________________________________________________________________
   XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
   XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
   XmNforeground           XmCForeground           Pixel               dynamic                CSG
   XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
   XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
   XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
   XmNinitialFocus         XmCInitialFocus         Widget              NULL                   CSG
   XmNnavigationType       XmCNavigationType       XmNavigationType    XmTAB_GROUP            CSG
   XmNshadowThickness      XmCShadowThickness      Dimension           0                      CSG
   XmNstringDirection      XmCStringDirection      XmStringDirection   dynamic                CG
   XmNtopShadowColor       XmCTopShadowColor       Pixel               dynamic                CSG
   XmNtopShadowPixmap      XmCTopShadowPixmap      Pixmap              dynamic                CSG
   XmNtraversalOn          XmCTraversalOn          Boolean             True                   CSG
   XmNunitType             XmCUnitType             unsigned char       dynamic                CSG
   XmNuserData             XmCUserData             XtPointer           NULL                   CSG



   1-500






                                                                XmManager(3X)



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

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

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

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

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

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

     XXmmN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o  The widget must be either a tab group or a non-tab-group
                    widget that can receive keyboard focus.  For the defini-
                    tion 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o  The widget must not be a descendant of a tab 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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o  When the manager is the child of a shell and the shell
                    hierarchy receives focus for the first time


   1-501






   XmManager(3X)



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

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

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

                 ++oo  XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP indicates that the widget is a tab
                    group and that widgets in the hierarchy whose XXmmNNnnaavviiggaa--
                    ttiioonnTTyyppee is XXmmTTAABB__GGRROOUUPP are not tab groups.
                    When a parent widget has an XXmmNNnnaavviiggaattiioonnTTyyppee of
                    XXmmEEXXCCLLUUSSIIVVEE__TTAABB__GGRROOUUPP, traversal of non-tab-group widgets
                    within the group is based on the order of those widgets
                    in their parent's XXmmNNcchhiillddrreenn list.
                    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


   1-502






                                                                XmManager(3X)


                    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 XXttSSeett--
                    V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l--
               lleettiinnBBooaarrdd and its descendants set this value dynamically.  If
               the widget is a top level window, this value is set to 1.  If
               it is not a top level window, this value is set to 0.

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

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

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

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

     XXmmNNu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 posi-
               tioning 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o  XXmmPPIIXXEELLSS-all values provided to the widget are treated as
                    normal pixel values.

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


   1-503






   XmManager(3X)



                 ++o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 hor-
                    izontal 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r--
                    t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.

     Dynamic Color Defaults

     The foreground, background, top shadow, bottom shadow, and highlight
     color resources are dynamically defaulted.  If no color data is speci-
     fied, 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 con-
     trast 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.

     Inherited Resources

     Manager inherits the following resources from the named superclasses.
     For a complete description of each resource, refer to the man page for
     that superclass.
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   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


   1-504






                                                                XmManager(3X)


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

     Callback Information

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

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

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

     Translations

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

     Action Routines

     The XmManager action routines are described below:



   1-505






   XmManager(3X)


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



   1-506






                                                                XmManager(3X)


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

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

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

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

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

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

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

     Additional Behavior

     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.

     Virtual Bindings

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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), XXmmC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-507






   XmMapSegmentEncoding(3X)



   NAME
     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 com-
     pound text encoding format associated with the specified font list tag

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

   DESCRIPTION
     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 asso-
     ciated 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

   RETURN VALUE
     Returns a copy of the associated compound text encoding format if the
     font list tag is found in the registry; otherwise, returns NULL.

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






                                                           XmMenuPosition(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     vvooiidd XXmmMMeennuuPPoossiittiioonn ((_m_e_n_u, _e_v_e_n_t))
          WWiiddggeett         _m_e_n_u;;
          XXBBuuttttoonnPPrreesssseeddEEvveenntt* _e_v_e_n_t;;

   DESCRIPTION
     XXmmMMeennuuPPoossiittiioonn positions a Popup MenuPane using the information in the
     specified event.  Unless an application is positioning the MenuPane
     itself, it must first invoke this function before managing the Popup-
     Menu.  The _x__r_o_o_t and _y__r_o_o_t values in the specified event are used to
     determine the menu position.

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

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

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

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





























   1-509






   XmMenuShell(3X)



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

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

   DESCRIPTION
     The MenuShell widget is a custom OverrideShell widget.  An OverrideShell
     widget bypasses mmwwmm when displaying itself.  It is designed specifically
     to contain Popup or Pulldown MenuPanes.

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

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

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

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

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

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

     For the managed child of a MenuShell, regardless of the value of the
     shell's XXmmNNaalllloowwSShheellllRReessiizzee, setting XXmmNNxx or XXmmNNyy sets the corresponding
     resource of the parent but does not change the child's position relative
     to the parent.  XXttGGeettVVaalluueess for the child's XXmmNNxx or XXmmNNyy yields the
     value of the corresponding resource in the parent.  The _x and _y coordi-
     nates of the child's upper left outside corner relative to the parent's
     upper left inside corner are both zero minus the value of XXmmNNbboorr--
     ddeerrWWiiddtthh.

     Classes

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



   1-510






                                                              XmMenuShell(3X)


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

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

     New Resources

     MenuShell overrides the XXmmNNaalllloowwSShheellllRReessiizzee resource in Shell.  The fol-
     lowing table defines a set of widget resources used by the programmer to
     specify data.  The programmer can also set the resource values for the
     inherited classes to set attributes for this widget.  To reference a
     resource by name or by class in a .Xdefaults file, remove the XXmmNN or XXmmCC
     prefix and use the remaining letters.  To specify one of the defined
     values for a resource in a .Xdefaults file, remove the XXmm prefix and use
     the remaining letters (in either lowercase or uppercase, but include any
     underscores between words).  The codes in the access column indicate if
     the given resource can be set at creation time (C), set by using XXttSSeett--
     VVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is not applicable
     (N/A).
                            XXmmMMeennuuSShheellll RReessoouurrccee SSeett
     NNaammee                 CCllaassss                TTyyppee         DDeeffaauulltt   AAcccceessss
     _______________________________________________________________________
     XmNbuttonFontList    XmCButtonFontList    XmFontList   dynamic   CSG
     XmNdefaultFontList   XmCDefaultFontList   XmFontList   dynamic   CG
     XmNlabelFontList     XmCLabelFontList     XmFontList   dynamic   CSG

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

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

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


   1-511






   XmMenuShell(3X)


               XXmmNNllaabbeellFFoonnttLLiisstt of the ancestor widget.  If no such ancestor
               is found, the default is implementation dependent.

     Inherited Resources

     MenuShell inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.  The following tables define a set of widget
     resources used by the programmer to specify data.  The programmer can
     set the resource values for these inherited classes to set attributes
     for this widget.  To reference a resource by name or by class in a .Xde-
     faults file, remove the XXmmNN or XXmmCC prefix and use the remaining letters.
     To specify one of the defined values for a resource in a .Xdefaults
     file, remove the XXmm prefix and use the remaining letters (in either
     lowercase or uppercase, but include any underscores between words).  The
     codes in the access column indicate if the given resource can be set at
     creation time (C), set by using XXttSSeettVVaalluueess (S), retrieved by using
     XXttGGeettVVaalluueess (G), or is not applicable (N/A).
                                            SShheellll RReessoouurrccee SSeett
   NNaammee                      CCllaassss                     TTyyppee                     DDeeffaauulltt          AAcccceessss
   ____________________________________________________________________________________________________
   XmNallowShellResize       XmCAllowShellResize       Boolean                  True             G
   XmNcreatePopupChildProc   XmCCreatePopupChildProc   XtCreatePopupChildProc   NULL             CSG
   XmNgeometry               XmCGeometry               String                   NULL             CSG
   XmNoverrideRedirect       XmCOverrideRedirect       Boolean                  True             CSG
   XmNpopdownCallback        XmCCallback               XtCallbackList           NULL             C
   XmNpopupCallback          XmCCallback               XtCallbackList           NULL             C
   XmNsaveUnder              XmCSaveUnder              Boolean                  True             CSG
   XmNvisual                 XmCVisual                 Visual *                 CopyFromParent   CSG
                              CCoommppoossiittee RReessoouurrccee SSeett
      NNaammee                CCllaassss               TTyyppee          DDeeffaauulltt   AAcccceessss
      ______________________________________________________________________
      XmNchildren         XmCReadOnly         WidgetList    NULL      G
      XmNinsertPosition   XmCInsertPosition   XtOrderProc   NULL      CSG
      XmNnumChildren      XmCReadOnly         Cardinal      0         G
                                                 CCoorree RReessoouurrccee SSeett
   NNaammee                            CCllaassss                           TTyyppee             DDeeffaauulltt                AAcccceessss
   ______________________________________________________________________________________________________________
   XmNaccelerators                 XmCAccelerators                 XtAccelerators   dynamic                CSG
   XmNancestorSensitive            XmCSensitive                    Boolean          dynamic                G
   XmNbackground                   XmCBackground                   Pixel            dynamic                CSG
   XmNbackgroundPixmap             XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderColor                  XmCBorderColor                  Pixel            XtDefaultForeground    CSG
   XmNborderPixmap                 XmCPixmap                       Pixmap           XmUNSPECIFIED_PIXMAP   CSG
   XmNborderWidth                  XmCBorderWidth                  Dimension        1                      CSG
   XmNcolormap                     XmCColormap                     Colormap         dynamic                CG
   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


   1-512






                                                              XmMenuShell(3X)


   XmNwidth                        XmCWidth                        Dimension        dynamic                CSG
   XmNx                            XmCPosition                     Position         0                      CSG
   XmNy                            XmCPosition                     Position         0                      CSG

     Translations

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

     Action Routines

     The XmMenuShell action routines are described below:

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

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

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

     Virtual Bindings

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

   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoorree((33XX)), OOvveerrrriiddeeSShheellll((33XX)), SShheellll((33XX)),
     XXmmCCrreeaatteeMMeennuuSShheellll((33XX)), XXmmCCrreeaatteePPooppuuppMMeennuu((33XX)), XXmmCCrreeaatteePPuullllddoowwnn((33XX)), and
     XXmmRRoowwCCoolluummnn((33XX)).













   1-513






   XmMessageBox(3X)



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

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

   DESCRIPTION
     MessageBox is a dialog class used for creating simple message dialogs.
     Convenience dialogs based on MessageBox are provided for several common
     interaction tasks, which include giving information, asking questions,
     and reporting errors.

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

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

     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 chil-
     dren 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 pix-
     map symbol resources are specified, the appropriate child will be
     created.

     Additional children are laid out in the following manner:

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

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

       ++o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 chil-
          dren is undefined.





   1-514






                                                             XmMessageBox(3X)


     At initialization, MessageBox looks for the following bitmap files:

       ++oo  xm_error

       ++oo  xm_information

       ++oo  xm_question

       ++oo  xm_working

       ++oo  xm_warning

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

     Classes

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

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

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

     New Resources

     The following table defines a set of widget resources used by the pro-
     grammer to specify data.  The programmer can also set the resource
     values for the inherited classes to set attributes for this widget.  To
     reference a resource by name or by class in a .Xdefaults file, remove
     the XXmmNN or XXmmCC prefix and use the remaining letters.  To specify one of
     the defined values for a resource in a .Xdefaults file, remove the XXmm
     prefix and use the remaining letters (in either lowercase or uppercase,
     but include any underscores between words).  The codes in the access
     column indicate if the given resource can be set at creation time (C),
     set by using XXttSSeettVVaalluueess (S), retrieved by using XXttGGeettVVaalluueess (G), or is
     not applicable (N/A).
                                     XXmmMMeessssaaggeeBBooxx RReessoouurrccee SSeett
   NNaammee                   CCllaassss                  TTyyppee             DDeeffaauulltt                 AAcccceessss
   _____________________________________________________________________________________________
   XmNcancelCallback      XmCCallback            XtCallbackList   NULL                    C
   XmNcancelLabelString   XmCCancelLabelString   XmString         dynamic                 CSG
   XmNdefaultButtonType   XmCDefaultButtonType   unsigned char    XmDIALOG_OK_BUTTON      CSG
   XmNdialogType          XmCDialogType          unsigned char    XmDIALOG_MESSAGE        CSG
   XmNhelpLabelString     XmCHelpLabelString     XmString         dynamic                 CSG
   XmNmessageAlignment    XmCAlignment           unsigned char    XmALIGNMENT_BEGINNING   CSG
   XmNmessageString       XmCMessageString       XmString         ""                      CSG
   XmNminimizeButtons     XmCMinimizeButtons     Boolean          False                   CSG
   XmNokCallback          XmCCallback            XtCallbackList   NULL                    C
   XmNokLabelString       XmCOkLabelString       XmString         dynamic                 CSG
   XmNsymbolPixmap        XmCPixmap              Pixmap           dynamic                 CSG





   1-515






   XmMessageBox(3X)



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

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

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

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

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

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

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

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

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

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

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

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

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

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

                 ++oo  XXmmDDIIAALLOOGG__WWOORRKKIINNGG-indicates a WorkingDialog
               If this resource is changed via XXttSSeettVVaalluueess, the symbol bitmap
               is modified to the new XXmmNNddiiaallooggTTyyppee bitmap unless XXmmNNssyymmbbooll--
               PPiixxmmaapp is also being set in the call to XXttSSeettVVaalluueess.  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


   1-516






                                                             XmMessageBox(3X)


               for this resource depends on the locale.  In the C locale the
               default is "Help".

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

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

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

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

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

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

     XXmmNNookkCCaallllbbaacckk
               Specifies the list of callbacks that is called when the user
               clicks on the OK button.  The reason sent by the callback is
               XXmmCCRR__OOKK.

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

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

     Inherited Resources

     MessageBox inherits behavior and resources from the following superc-
     lasses.  For a complete description of each resource, refer to the man
     page for that superclass.
                              XXmmBBuulllleettiinnBBooaarrdd RReessoouurrccee SSeett
   NNaammee                  CCllaassss                TTyyppee             DDeeffaauulltt         AAcccceessss
   __________________________________________________________________________________
   XmNallowOverlap       XmCAllowOverlap      Boolean          True            CSG
   XmNautoUnmanage       XmCAutoUnmanage      Boolean          True            CG
   XmNbuttonFontList     XmCButtonFontList    XmFontList       dynamic         CSG
   XmNcancelButton       XmCWidget            Widget           Cancel button   SG
   XmNdefaultButton      XmCWidget            Widget           dynamic         SG
   XmNdefaultPosition    XmCDefaultPosition   Boolean          True            CSG
   XmNdialogStyle        XmCDialogStyle       unsigned char    dynamic         CSG
   XmNdialogTitle        XmCDialogTitle       XmString         NULL            CSG
   XmNfocusCallback      XmCCallback          XtCallbackList   NULL            C
   XmNlabelFontList      XmCLabelFontList     XmFontList       dynamic         CSG
   XmNmapCallback        XmCCallback          XtCallbackList   NULL            C
   XmNmarginHeight       XmCMarginHeight      Dimension        10              CSG


   1-517






   XmMessageBox(3X)


   XmNmarginWidth        XmCMarginWidth       Dimension        10              CSG
   XmNnoResize           XmCNoResize          Boolean          False           CSG
   XmNresizePolicy       XmCResizePolicy      unsigned char    XmRESIZE_ANY    CSG
   XmNshadowType         XmCShadowType        unsigned char    XmSHADOW_OUT    CSG
   XmNtextFontList       XmCTextFontList      XmFontList       dynamic         CSG
   XmNtextTranslations   XmCTranslations      XtTranslations   NULL            C
   XmNunmapCallback      XmCCallback          XtCallbackList   NULL            C
                                        XXmmMMaannaaggeerr RReessoouurrccee SSeett
   NNaammee                    CCllaassss                   TTyyppee                DDeeffaauulltt                AAcccceessss
   _________________________________________________________________________________________________
   XmNbottomShadowColor    XmCBottomShadowColor    Pixel               dynamic                CSG
   XmNbottomShadowPixmap   XmCBottomShadowPixmap   Pixmap              XmUNSPECIFIED_PIXMAP   CSG
   XmNforeground           XmCForeground           Pixel               dynamic                CSG
   XmNhelpCallback         XmCCallback             XtCallbackList      NULL                   C
   XmNhighlightColor       XmCHighlightColor       Pixel               dynamic                CSG
   XmNhighlightPixmap      XmCHighlightPixmap      Pixmap              dynamic                CSG
   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



   1-518






                                                             XmMessageBox(3X)


     Callback Information

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

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

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

     Translations

     XmMessageBox includes the translations from XmManager.

     Additional Behavior

     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 Dia-
               logShell.

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

     Virtual Bindings

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






   XmMessageBox(3X)



   RELATED INFORMATION
     CCoommppoossiittee((33XX)), CCoonnssttrraaiinntt((33XX)), CCoorree((33XX)), 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-520






                                                     XmMessageBoxGetChild(3X)



   NAME
     XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd-A MessageBox function that is used to access a com-
     ponent

   SYNOPSIS
     ##iinncclluuddee <<XXmm//MMeessssaaggeeBB..hh>>
     WWiiddggeett XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd ((_w_i_d_g_e_t, _c_h_i_l_d))
          WWiiddggeett    _w_i_d_g_e_t;;
          uunnssiiggnneedd cchhaarr_c_h_i_l_d;;

   DESCRIPTION
     XXmmMMeessssaaggeeBBooxxGGeettCChhiilldd is used to access a component within a MessageBox.
     The parameters given to the function are the MessageBox widget and a
     value indicating which component to access.

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

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

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

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

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

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

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

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

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

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

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

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











   1-521






   XmOptionButtonGadget(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmOOppttiioonnBBuuttttoonnGGaaddggeett ((_o_p_t_i_o_n__m_e_n_u))
          WWiiddggeett    _o_p_t_i_o_n__m_e_n_u;;

   DESCRIPTION
     XXmmOOppttiioonnBBuuttttoonnGGaaddggeett provides the application with the means for obtain-
     ing the widget ID for the internally created CascadeButtonGadget.  Once
     the application has obtained the widget ID, it can adjust the visuals
     for the CascadeButtonGadget, if desired.

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

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

       ++oo

       ++oo  Option Menu Label Gadget-"OptionLabel"

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

   RETURN VALUE
     Returns the widget ID for the internal button.

   RELATED INFORMATION
     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmCCaassccaaddeeBBuuttttoonnGGaaddggeett((33XX)),
     XXmmOOppttiioonnLLaabbeellGGaaddggeett((33XX)), and XXmmRRoowwCCoolluummnn((33XX)).











   1-522






                                                      XmOptionLabelGadget(3X)



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

   SYNOPSIS
     ##iinncclluuddee <<XXmm//RRoowwCCoolluummnn..hh>>
     WWiiddggeett XXmmOOppttiioonnLLaabbeellGGaaddggeett ((_o_p_t_i_o_n__m_e_n_u))
          WWiiddggeett    _o_p_t_i_o_n__m_e_n_u;;

   DESCRIPTION
     XXmmOOppttiioonnLLaabbeellGGaaddggeett provides the application with the means for obtain-
     ing the widget ID for the internally created LabelGadget.  Once the
     application has obtained the widget ID, it can adjust the visuals for
     the LabelGadget, if desired.

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

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

       ++oo

       ++oo  Option Menu Label Gadget-"OptionLabel"

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

   RETURN VALUE
     Returns the widget ID for the internal label.

   RELATED INFORMATION
     XXmmCCrreeaatteeOOppttiioonnMMeennuu((33XX)), XXmmLLaabbeellGGaaddggeett((33XX)), XXmmOOppttiioonnBBuuttttoonnGGaaddggeett((33XX)), and
     XXmmRRoowwCCoolluummnn((33XX)).











   1-523



 )
