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 オブジェクトの配列。 配列には少なくとも 1 つ要素が含まれますが、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 実際のオブジェクトのインスタンス (存在する場合) も表示されます。