Chart.HitTest 方法

定义

命名空间:

System.Web.UI.DataVisualization.Charting

程序集:

System.Web.DataVisualization.dll

确定位于由所给定 X、Y 坐标定义的点处的图表元素（如果有）。

重载

HitTest(Int32, Int32, Boolean, ChartElementType[])	确定指定类型之一的图表元素是否位于给定 X 和 Y 坐标定义的点。
HitTest(Int32, Int32, ChartElementType)	确定给定类型的图表元素是否位于由给定的 X 和 Y 坐标定义的点处。
HitTest(Int32, Int32)	确定位于由所给定 X、Y 坐标定义的点处的图表元素（如果有）。
HitTest(Int32, Int32, Boolean)	确定位于由给定 X 和 Y 坐标定义的点处的图表元素（如果有）。 可以选择忽略透明元素。

注解

调用此方法可确定位于指定点的图表元素（如果有）。

此方法通常用于某些与鼠标相关的事件（例如 MouseDown），以确定最终用户单击的图表元素。 然后，从事件参数获取的 X 和 Y 鼠标坐标将用于 x 此方法调用的 和 y 参数值。

然后，可以使用返回 HitTestResult 对象的属性来确定单击了哪个图表元素; HitTestResult 对象还提供所选实际对象的实例（如果有）。

HitTest(Int32, Int32, Boolean, ChartElementType[])

确定指定类型之一的图表元素是否位于给定 X 和 Y 坐标定义的点。

public:
 cli::array <System::Web::UI::DataVisualization::Charting::HitTestResult ^> ^ HitTest(int x, int y, bool ignoreTransparent, ... cli::array <System::Web::UI::DataVisualization::Charting::ChartElementType> ^ requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult[] HitTest (int x, int y, bool ignoreTransparent, params System.Web.UI.DataVisualization.Charting.ChartElementType[] requestedElement);

member this.HitTest : int * int * bool * System.Web.UI.DataVisualization.Charting.ChartElementType[] -> System.Web.UI.DataVisualization.Charting.HitTestResult[]

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean, ParamArray requestedElement As ChartElementType()) As HitTestResult()

参数

x

Int32

指定数据点的 X 坐标。

y

Int32

指定数据点的 Y 坐标。

ignoreTransparent

Boolean

一个标志，该标志指示应忽略透明元素。

requestedElement

ChartElementType[]

一个 ChartElementType 对象数组，这些对象指定要测试的类型，以便筛选结果。 如果省略，则将忽略检查元素类型，所有元素类型都将有效。

返回

HitTestResult[]

一个 HitTestResult 对象数组，这些对象提供有关在指定位置找到的图表元素（如果有）的信息。 数组至少包含一个元素，可以是 Nothing。 结果中的对象在不同控件层中按从顶部到底部的顺序排序。

注解

调用此方法可确定位于指定点的仪表元素（如果有）。 此方法通常用于某些与鼠标相关的事件（例如 MouseDown），以确定最终用户单击的仪表元素。 然后，从事件参数获取的 X 和 Y 鼠标坐标将用于此方法调用的 X 和 Y 参数值。

然后，可以使用返回 HitTestResult 对象的属性来确定单击了哪个图表元素; HitTestResult 对象还提供所选实际对象的实例（如果有）。

HitTest(Int32, Int32, ChartElementType)

确定给定类型的图表元素是否位于由给定的 X 和 Y 坐标定义的点处。

public:
 System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, System::Web::UI::DataVisualization::Charting::ChartElementType requestedElement);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, System.Web.UI.DataVisualization.Charting.ChartElementType requestedElement);

member this.HitTest : int * int * System.Web.UI.DataVisualization.Charting.ChartElementType -> System.Web.UI.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, requestedElement As ChartElementType) As HitTestResult

参数

x

Int32

用户所单击的点的 X 坐标值。

y

Int32

用户所单击的点的 Y 坐标值。

requestedElement

ChartElementType

一个标志，该标志决定了要测试的图表元素类型。

返回

HitTestResult

一个 HitTestResult 对象，提供有关在指定位置处找到的图表元素（如果有）的信息。

注解

调用此方法可确定给定类型的图表元素是否位于指定点。

重要

若要使此方法正常工作， IsMapEnabled 必须将 属性设置为 false。

实现向下钻取时， Click 此方法可与服务器端事件一起使用。 但是，由于易于使用，强烈建议使用客户端图像映射进行向下钻取。

然后，可以使用返回 HitTestResult 对象的属性来确定单击了哪个图表元素; HitTestResult 对象还提供所选实际对象的实例（如果有）。

HitTest(Int32, Int32)

确定位于由所给定 X、Y 坐标定义的点处的图表元素（如果有）。

public:
 System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Web.UI.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer) As HitTestResult

参数

x

Int32

用户所单击的点的 X 坐标值。

y

Int32

用户所单击的点的 Y 坐标值。

返回

HitTestResult

一个 HitTestResult 对象，该对象提供有关指定位置处的图表元素（如果有）的信息。

注解

调用此方法可确定位于指定点的图表元素（如果有）。

重要

若要使此方法正常工作， IsMapEnabled 必须将 属性设置为 false。

实现向下钻取时， Click 此方法可与服务器端事件一起使用。 但是，由于易于使用，强烈建议使用客户端图像映射进行向下钻取。

然后，可以使用返回 HitTestResult 对象的属性来确定单击了哪个图表元素; HitTestResult 对象还提供所选实际对象的实例（如果有）。

HitTest(Int32, Int32, Boolean)

确定位于由给定 X 和 Y 坐标定义的点处的图表元素（如果有）。 可以选择忽略透明元素。

public:
 System::Web::UI::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y, bool ignoreTransparent);

public System.Web.UI.DataVisualization.Charting.HitTestResult HitTest (int x, int y, bool ignoreTransparent);

member this.HitTest : int * int * bool -> System.Web.UI.DataVisualization.Charting.HitTestResult

Public Function HitTest (x As Integer, y As Integer, ignoreTransparent As Boolean) As HitTestResult

参数

x

Int32

用户所单击的点的 X 坐标值。

y

Int32

用户所单击的点的 Y 坐标值。

ignoreTransparent

Boolean

一个决定是否忽略透明元素的标志。

返回

HitTestResult

一个 HitTestResult 对象，该对象提供有关指定位置处的图表元素（如果有）的信息。

注解

调用此方法可确定位于指定点的图表元素（如果有）。

若要忽略透明元素，请将 ignoreTransparent 参数设置为 true。

重要

若要使此方法正常工作， IsMapEnabled 必须将 属性设置为 false。

实现向下钻取时， Click 此方法可与服务器端事件一起使用。 但是，由于易于使用，强烈建议使用客户端图像映射进行向下钻取。

然后，可以使用返回 HitTestResult 对象的属性来确定单击了哪个图表元素; HitTestResult 对象还提供所选实际对象的实例（如果有）。