


DXmSvnGetHighlighted(3X)			     DXmSvnGetHighlighted(3X)



NAME
  DDXXmmSSvvnnGGeettHHiigghhlliigghhtteedd - Retrieves (returns) a list of entries currently
  highlighted by the user.

SYNOPSIS

  vvooiidd DDXXmmSSvvnnGGeettHHiigghhlliigghhtteedd ((_w_i_d_g_e_t,, _e_n_t_r_i_e_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(());;
	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 highlighted entry
      numbers.

  _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 highlighted entry.  If tags are not required,
      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tHHiigghhlliigghhtteedd routine returns a list of entries that are
  currently highlighted	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 highlighted 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.










