ObjectDCL Banner

ListView_HitPointTest Method

Description

This method will test to see which row and column (if columns exit) a point belongs to.

Parameters

MyControlReference
Reference to the control in the form of MyProject_MyForm_MyControl.
ProjectFile
String identifying the project as it was passed in LoadProject.
DialogName
String identifying the dialog by name.
ControlName
String identifying the control by name.
nX
Integer specifying the X-axis coordinate within the control.
nY
Integer specifying the Y-axis coordinate within the control.

Return Values

Returns the following according to the situation:

  • Integer specifying the row.
  • List of two integer specifying the row and column for the Report style.
  • Nil if the control is not found or does not support this function.

AutoLISP Syntax

The recommended convention is passing the control identifier directly:

CopyCode imageCopy Code
(Odcl_ListView_HitPointTest 
		MyControlReference [as Reference]
		nX [as Integer]
		nY [as Integer])

An alternative convention is to identify the control by providing the project file, the dialog name and the control name:

CopyCode imageCopy Code
(Odcl_ListView_HitPointTest
		ProjectFile [as String]
		DialogName [as String]
		ControlName [as String]
		nX [as Integer]
		nY [as Integer])

Applies For

ListView.

Example

CopyCode imageCopy Code
; Determine what we touch at this position
(setq rValue (Odcl_ListView_HitPointTest MyProject_MyForm_MyControl 34 67))