ItemHitTest Method (TREEVIEW)

9.1C, PLBCMP GUI Only

The ItemHitTest method returns the item and sub item number in a TREEVIEW object for a given point on the screen. The method uses the following format:

[label]	{object}.ItemHitTest	[GIVING {return}] USING [Horz=]{horz*}:
		[Vert=]{vert*}

Where:

label

Optional. A Program Execution Label.

object

Required. A TREEVIEW object that is accessed.

return

Optional. A Numeric Variable that returns the item or sub item number.

horz

Required. A decimal number or Numeric Variable that specifies the horizontal position to test.

vert

Required. A decimal number or Numeric Variable that specifies the vertical position to test.

Flags Affected: EOS, OVER, ZERO

Note the following:

Upon completion, {return} is a number indicating the item within the object hit or zero (0) if none hit.
If the value returned is zero, the ZERO condition flag is set.
The OVER and EOS Condition Flags are always cleared.

See Also: Method Syntax, TREEVIEW Methods