


DXmSvnGetSelections(3X)				      DXmSvnGetSelections(3X)



NAME
  DDXXmmSSvvnnGGeettSSeelleeccttiioonnss -	Retrieves (returns) a list of selected entry numbers.

SYNOPSIS

  vvooiidd DDXXmmSSvvnnGGeettSSeelleeccttiioonnss ((_w_i_d_g_e_t,, _e_n_t_r_i_e_s,, _c_o_m_p_s,, _t_a_g_s,, _l_e_n))
	WWiiddggeett	       _w_i_d_g_e_t;;
	iinntt	       **_e_n_t_r_i_e_s(());;
	iinntt	       **_c_o_m_p_s(());;
	XXttPPooiinntteerr      **_t_a_g_s(());;
	iinntt	       _l_e_n;;

PARAMETERS

  _w_i_d_g_e_t
      The identifier (widget ID) of the	SVN widget.

  _e_n_t_r_i_e_s
      A	pointer	to an array of integers	to receive the selected	entry
      numbers.

  _c_o_m_p_s
      A	pointer	to an array of integers	to receive the component numbers on
      which the	entry was selected.  A component number	of 0 means that	the
      entry was	selected using range selection and not by directly clicking
      on the entry.  If	components are not needed, a Null pointer may be
      passed.

  _t_a_g_s
      A	pointer	to an array of longwords to receive the	application tag	value
      for each entry selected.	If tags	are not	needed,	a Null pointer may be
      passed.

  _l_e_n An integer that represents the number of entries allocated in the	pro-
      vided array.

DESCRIPTION

  The DDXXmmSSvvnnGGeettSSeelleeccttiioonnss routine returns a list of entries that are
  currently selected by	the user.  Make	this call in your application between
  calls	to DDXXmmSSvvnnDDiissaabblleeDDiissppllaayy	and DDXXmmSSvvnnEEnnaabblleeDDiissppllaayy	to ensure that the
  selected list	is not changing.

  The application is responsible for managing the memory used to return	this
  list of highlighted entries.	As such, note the following:

    oo++  At the minimum, the number of entries in	the array should be capable
       of holding the number of	entries	indicated by the value returned	from
       the DDXXmmSSvvnnGGeettNNuummHHiigghhlliigghhtteedd routine.

    oo++  If there	are more entries in the	array than the application will	need,
       the SVN widget will set the value for those extra entries to 0.

    oo++  If the capacity of the arrays passed is less than the number of
       selected	entries, only the number of entries allocated in the provided
       array (the value	for _l_e_n) will be returned.



