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[])

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

指定した種類の 1 つであるグラフ要素が、指定された 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 オブジェクトの配列。 配列には少なくとも 1 つの要素が含まれており、 Nothingできます。 結果内のオブジェクトは、コントロールのさまざまなレイヤーの上から下に並べ替えられます。

注釈

このメソッドを呼び出して、ゲージ要素 (存在する場合) を特定します。ゲージ要素がある場合は、指定したポイントに配置されます。 このメソッドは、エンドユーザーがクリックしたゲージ要素を決定するために、マウス関連のイベント ( OnMouseDownなど) でよく使用されます。 イベント パラメーターから取得した X と Y のマウス座標は、このメソッド呼び出しの X および Y パラメーター値に使用されます。

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

適用対象