


DXmSvnGetEntryPosition(3X)			   DXmSvnGetEntryPosition(3X)



NAME
  DDXXmmSSvvnnGGeettEEnnttrryyPPoossiittiioonn - Retrieves (returns) the position of an entry	in
  the display.

SYNOPSIS

  vvooiidd DDXXmmSSvvnnGGeettEEnnttrryyPPoossiittiioonn ((_w_i_d_g_e_t,, _e_n_t_r_y,, _m_o_d_e,, _x,, _y))
	WWiiddggeett	 _w_i_d_g_e_t;;
	iinntt	 _e_n_t_r_y;;
	BBoooolleeaann	 _m_o_d_e;;
	iinntt	 **_x;;
	iinntt	 **_y;;

PARAMETERS

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

  _e_n_t_r_y
      An integer that represents the number of the entry for which position
      information is required.

  _m_o_d_e
      A	Boolean	value that, when True, specifies that position information
      returned is relative to the upper-left corner of the SVN window.	When
      False, the position information returned is internal SVN information
      only (for	column and outline mode) or indicates the position of the
      entry in the entire tree (tree mode).

  _x   A	pointer	to the _x position in the tree.

  _y   A	pointer	to the _y position in the tree.

DESCRIPTION

  The DDXXmmSSvvnnGGeettEEnnttrryyPPoossiittiioonn routine allows an application to determine	the
  position of entries. The routine interprets the _x and	_y coordinates dif-
  ferently, depending on the application's mode:

    oo++  Outline and Column mode

       When the	application is in outline or column mode (the DDXXMMSSvvnnNNddiissppllaayy--
       MMooddee resource has been set to either DDXXMMSSvvnnKKddiissppllaayyOOuuttlliinnee or
       DDXXMMSSvvnnKKddiissppllaayyCCoolluummnn )) and _m_o_d_e for the DDXXmmSSvvnnGGeettEEnnttrryyPPoossiittiioonn routine
       has been	set to True, the _x and _y coordinates indicate, in pixels, the
       distance	of the displayed entry from the	upper-left corner of the SVN
       window.

       However,	if the specified entry is _n_o_t visible in the SVN window, the
       routine returns -1 (an invalid value) for both the _x and	_y coordi-
       nates, because the SVN widget cannot determine the position of such an
       entry when the application is in	outline	or column mode.

       When _m_o_d_e is False, the values returned for the _x and _y coordinates
       are only	meaningful internally to the SVN widget.

    oo++  Tree mode

       When the	application is in tree mode (the DDXXMMSSvvnnNNddiissppllaayyMMooddee resource
       is set to DDXXMMSSvvnnKKddiissppllaayyTTrreeee )) and the DDXXMMSSvvnnNNttrreeeeSSttyyllee resource	is
       set to DDXXMMSSvvnnKKuusseerrDDeeffiinneeddTTrreeee (the application controls the format),
       the _x and _y coordinates indicate, in pixels, the	distance of the
       displayed entry from the	upper-left corner of the SVN window, when
       _m_o_d_e is True.

       If the entry is _n_o_t visible in the SVN window, the _m_o_d_e is False.
       However,	in tree	mode, the returned _x and _y coordinates indicate	the
       position	of the entry in	the entire tree, even though that position
       extends beyond the limit	of what	can currently be displayed in the SVN
       window.

       Note that for position values to	be valid, the SVN widget must have
       been enabled prior to any changes made to the contents of the display.




















































