


XmListReplaceItemsPos(3X)			    XmListReplaceItemsPos(3X)
OSF/Motif							    OSF/Motif



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











