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 物件也會提供選取之實際對象的實例，如果有的話。