


XmListReplaceItemsUnselected(3X)	     XmListReplaceItemsUnselected(3X)
OSF/Motif							    OSF/Motif



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
















