Chart.HitTest 方法

定義

命名空間:: System.Windows.Forms.DataVisualization.Charting

組件:: System.Windows.Forms.DataVisualization.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

決定由給定的 X 與 Y 座標定義的點的圖表元素（若有）。

多載

名稱	Description
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()