Chart.HitTest 方法

定义

确定位于由所给定 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 对象数组,这些对象提供有关在指定位置找到的图表元素(如果有)的信息。 数组至少包含一个元素,可以是 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 对象,提供有关在指定位置处找到的图表元素(如果有)的信息。

注解

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

重要

若要使此方法正常工作, 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 对象,该对象提供有关指定位置处的图表元素(如果有)的信息。

注解

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

重要

若要使此方法正常工作, 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 对象,该对象提供有关指定位置处的图表元素(如果有)的信息。

注解

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

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

重要

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

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

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

适用于