次の方法で共有

Chart.HitTest メソッド

定義

名前空間:
System.Web.UI.DataVisualization.Charting
アセンブリ:
System.Web.DataVisualization.dll

指定された X 座標と Y 座標によって定義されたポイントにあるグラフ要素 (存在する場合) を決定します。

オーバーロード

名前 説明
HitTest(Int32, Int32, Boolean, ChartElementType[])

指定した種類の 1 つであるグラフ要素が、指定された 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[])

指定した種類の 1 つであるグラフ要素が、指定された 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 オブジェクト。

注釈

このメソッドを呼び出して、指定した型のグラフ要素が指定した位置にあるかどうかを判断します。

Important

このメソッドを正しく機能させるには、 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 オブジェクト。

注釈

このメソッドを呼び出して、指定したポイントにあるグラフ要素 (存在する場合) を確認します。

Important

このメソッドを正しく機能させるには、 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 に設定します。

Important

このメソッドを正しく機能させるには、 IsMapEnabled プロパティを false に設定する必要があります。

このメソッドは、ドリルダウンを実装するときに Click サーバー側イベントと共に使用できます。 ただし、使いやすさのため、ドリルダウンにはクライアント側のイメージ マップを使用することを強くお勧めします。

返された HitTestResult オブジェクトのプロパティを使用して、クリックされたグラフ要素を特定できます。 HitTestResult オブジェクトには、選択した実際のオブジェクトのインスタンス (存在する場合) も表示されます。

適用対象