Chart.HitTest 方法

定义

命名空间:

System.Windows.Forms.DataVisualization.Charting

程序集:

System.Windows.Forms.DataVisualization.dll

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

重载

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

注解

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

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

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

HitTest(Int32, Int32)

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

public:
 System::Windows::Forms::DataVisualization::Charting::HitTestResult ^ HitTest(int x, int y);

public System.Windows.Forms.DataVisualization.Charting.HitTestResult HitTest (int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.DataVisualization.Charting.HitTestResult

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

参数

x

Int32

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

y

Int32

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

返回

HitTestResult

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

注解

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

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

HitTest(Int32, Int32, Boolean)

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

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

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

member this.HitTest : int * int * bool -> System.Windows.Forms.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

忽略透明元素，则为 true；否则为 false。

返回

HitTestResult

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

注解

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

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

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

HitTest(Int32, Int32, ChartElementType)

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

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

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

member this.HitTest : int * int * System.Windows.Forms.DataVisualization.Charting.ChartElementType -> System.Windows.Forms.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 对象，该对象提供有关指定位置处的图表元素（如果有）的信息。

注解

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

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

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

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

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

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

member this.HitTest : int * int * bool * System.Windows.Forms.DataVisualization.Charting.ChartElementType[] -> System.Windows.Forms.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

忽略透明元素，则为 true；否则为 false。

requestedElement

ChartElementType[]

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

返回

HitTestResult[]

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

注解

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

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