


XmListReplacePositions(3X)			   XmListReplacePositions(3X)
OSF/Motif							    OSF/Motif



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
















