Chart.HitTest 方法

定義

命名空間:

System.Web.UI.DataVisualization.Charting

組件:

System.Web.DataVisualization.dll

判斷圖表項目 (如果有的話)，此項目位於指定之 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[]

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

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

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

HitTestResult 物件，這個物件可提供指定之位置的圖表項目 (如果有的話) 相關資料。

備註

呼叫這個方法，以判斷圖表專案，如果有的話，該元素位於指定的點。

若要忽略透明元素，請將 ignoreTransparent 參數設定為 true 。

重要

為了讓這個方法正常運作， IsMapEnabled 屬性必須設定為 false 。

當您實作向下鑽研時，這個方法可以與伺服器端事件搭配 Click 使用。 不過，強烈建議您使用用戶端影像對應進行向下鑽研，因為容易使用。

然後，傳回 HitTestResult 物件的屬性可用來判斷按下哪一個圖表專案; HitTestResult 如果有任何的話，物件也會提供所選取之實際物件的實例。