


DXmSvnGetDisplayed(3X)				       DXmSvnGetDisplayed(3X)



NAME
  DDXXmmSSvvnnGGeettDDiissppllaayyeedd - Retrieves (returns) displayed entry numbers and
  related information necessary	to draw	a corresponding	display.

SYNOPSIS

  vvooiidd DDXXmmSSvvnnGGeettDDiissppllaayyeedd ((_w_i_d_g_e_t,, _e_n_t_r_i_e_s,, _t_a_g_s,, _y_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(());;
	XXttPPooiinntteerr     **_t_a_g_s(());;
	iinntt	      **_y_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 entry numbers of	the
      entries being displayed.

  _t_a_g_s
      A	pointer	to an array of longwords to receive the	application's
      _e_n_t_r_y__t_a_g	value for each entry displayed.	 If tags are not required, a
      Null pointer may be passed.

  _y_s  A	pointer	to an array of longwords to receive the	_y coordinates for
      each entry displayed.  If	_y coordinates are not required,	a Null
      pointer can be passed.

  _l_e_n The number of entries allocated in the provided array.

DESCRIPTION

  The DDXXmmSSvvnnGGeettDDiissppllaayyeedd routine returns information about the entries that
  the SVN widget is currently displaying.  This	information can	then be	used
  to keep a simultaneous display up to date with the SVN widget	window (in
  the case of a	dialog box, for	example, which might contain totals for	the
  entries being	displayed).

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

    oo++  At the minimum, the number of entries in	the array should be capable
       of holding at least the number of entries indicated by the value
       returned	from the DDXXmmSSvvnnGGeettNNuummDDiissppllaayye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.





