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 对象还提供所选的实际对象的实例（如果有）。