


XmListReplaceItems(3X)				       XmListReplaceItems(3X)
OSF/Motif							    OSF/Motif



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

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















