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[])	指定した型のグラフ要素を、指定した 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 オブジェクト (存在する場合)。

注釈

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

透明な要素を無視するには、パラメーターtrueを ignoreTransparent .

返されるオブジェクトの 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[])

指定した型のグラフ要素を、指定した 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 実際のオブジェクトのインスタンス (存在する場合) も表示されます。