Dundas Chart for ASP.NET
HitTest(Int32,Int32,ChartElementType) Method
See Also  Send comments on this topic.
Dundas.Charting.WebControl Namespace > Chart Class > HitTest Method : HitTest(Int32,Int32,ChartElementType) Method


x
The x-coordinate value of the point the user clicked on.
X coordinate
y
The y-coordinate value of the point the user clicked on.
Y coordinate
requestedElement
Determines the chart element type to be tested.
Only this chart elements will be hit tested.

Call this method to determine if a chart element of a given type is located at a point defined by given X and Y coordinates.


This method is used for selection and it returns a selected object from x and y coordinates.

Syntax

Visual Basic (Declaration)  
Public Overloads Function HitTest( _
   ByVal x As Integer, _
   ByVal y As Integer, _
   ByVal requestedElement As ChartElementType _
) As HitTestResult
Visual Basic (Usage) Copy Code
Dim instance As Chart
Dim x As Integer
Dim y As Integer
Dim requestedElement As ChartElementType
Dim value As HitTestResult
 
value = instance.HitTest(x, y, requestedElement)
C#  
public HitTestResult HitTest( 
   int x,
   int y,
   ChartElementType requestedElement
)

Parameters

x
The x-coordinate value of the point the user clicked on.
X coordinate
y
The y-coordinate value of the point the user clicked on.
Y coordinate
requestedElement
Determines the chart element type to be tested.
Only this chart elements will be hit tested.

Return Value

A HitTestResult object, which provides information concerning the chart element (if any) that is at the specified location.


Hit test result object

Remarks

Call this method to determine if a chart element of the given type is located at a specified point.

IMPORTANT: for this method to work correctly the Chart.MapEnabled property must be set to false.

This method can be used with the Click server-side event when implementing drilldown. However, we HIGHLY RECOMMEND using client-side image maps for drilldown because of its ease of use.

The returned HitTestResult object's properties can then be used to determine what chart element was clicked on, and also provides an instance of the actual object selected (if any).

Requirements

Target Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows Server 2008 family

See Also

Copyright © 2001 - 2009 Dundas Data Visualization, Inc. and others.