


XmListReplaceItemsPosUnselected(3X)	  XmListReplaceItemsPosUnselected(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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I--
  t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)).













