共用方式為


Chart.HitTest 方法

定義

判斷圖表項目 (如果有的話),此項目位於指定之 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 物件的陣列,提供在指定位置上找到的圖表項目 (如果有的話) 的相關資訊。 陣列包含至少一個項目,可能是 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 物件,這個物件提供在指定位置找到之圖表項目 (如果有的話) 的相關資料。

備註

呼叫這個方法,以判斷指定類型的圖表專案是否位於指定的點。

重要

為了讓這個方法正常運作, 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 物件,這個物件可提供指定之位置的圖表項目 (如果有的話) 相關資料。

備註

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

重要

為了讓這個方法正常運作, 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 物件,這個物件可提供指定之位置的圖表項目 (如果有的話) 相關資料。

備註

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

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

重要

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

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

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

適用於