This documentation is archived and is not being maintained.

Chart::HitTest Method (Int32, Int32, Boolean)

Determines the chart element, if any, that is located at a point defined by given X and Y coordinates. Transparent elements can optionally be ignored.

Namespace:  System.Web.UI.DataVisualization.Charting
Assembly:  System.Web.DataVisualization (in System.Web.DataVisualization.dll)

public:
HitTestResult^ HitTest(
	int x, 
	int y, 
	bool ignoreTransparent
)

Parameters

x
Type: System::Int32
The X-coordinate value of the point the user clicked on.
y
Type: System::Int32
The Y-coordinate value of the point the user clicked on.
ignoreTransparent
Type: System::Boolean
A flag that determines if transparent elements are ignored.

Return Value

Type: System.Web.UI.DataVisualization.Charting::HitTestResult
A HitTestResult object, which provides information concerning the chart element, if any, that is at the specified location.

Call this method to determine the chart element, if any, which is located at a specified point.

To ignore transparent elements, set the ignoreTransparent parameter to true.

Important noteImportant

In order for this method to work correctly, the IsMapEnabled property must be set to false.

This method can be used with the Click server-side event when you implement drilldown. However, it is highly recommended that you use client-side image maps for drilldown because of ease of use.

The properties of the returned HitTestResult object can then be used to determine which chart element was clicked; the HitTestResult object also provides an instance of the actual object selected, if any.

.NET Framework

Supported in: 4

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: