ListView.HitTest メソッド

定義

名前空間:

System.Windows.Forms

アセンブリ:

System.Windows.Forms.dll

指定した x 座標と y 座標の項目情報を提示します。

オーバーロード

HitTest(Point)	指定した位置の項目情報を提示します。
HitTest(Int32, Int32)	指定した x 座標と y 座標の項目情報を提示します。

HitTest(Point)

指定した位置の項目情報を提示します。

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(System::Drawing::Point point);

public System.Windows.Forms.ListViewHitTestInfo HitTest (System.Drawing.Point point);

member this.HitTest : System.Drawing.Point -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (point As Point) As ListViewHitTestInfo

パラメーター

point

Point

項目の情報を取得する位置を表す Point。 座標は、このコントロールの左上隅を起点とした相対座標です。

戻り値

ListViewHitTestInfo

指定した位置の項目情報。

例外

ArgumentOutOfRangeException

ポイントに、0 未満の座標が含まれています。

注釈

このメソッドを使用して、ポイントがアイテムまたはサブアイテム内にあるかどうか、およびラベルや画像領域など、ポイントが配置されているアイテム内の場所を判断します。 座標がコントロールの外部にある場合、返される ListViewHitTestInfo オブジェクトのプロパティは Location "None" で、 Item および SubItem プロパティは に null設定されます。

HitTest(Int32, Int32)

指定した x 座標と y 座標の項目情報を提示します。

public:
 System::Windows::Forms::ListViewHitTestInfo ^ HitTest(int x, int y);

public System.Windows.Forms.ListViewHitTestInfo HitTest (int x, int y);

member this.HitTest : int * int -> System.Windows.Forms.ListViewHitTestInfo

Public Function HitTest (x As Integer, y As Integer) As ListViewHitTestInfo

パラメーター

x

Int32

項目情報を取得する位置を表す x 座標。 座標は、このコントロールの左上隅を起点とした相対座標です。

y

Int32

項目情報を取得する位置を表す y 座標。 座標は、このコントロールの左上隅を起点とした相対座標です。

戻り値

ListViewHitTestInfo

指定した x 座標と y 座標の項目情報。

例外

ArgumentOutOfRangeException

x 座標または y 座標が 0 未満です。

例

次のコード例では、 メソッドを HitTest 使用して、 内のマウス イベントの位置を確認する方法を ListView示します。 この例を実行するには、項目が設定された という名前listView1が含ListViewまれる Windows フォームに貼り付けます。 のイベントlistView1をMouseDown、この例の listView1_MouseDown メソッドに関連付けます。

void HandleMouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = listView1.HitTest(e.X, e.Y);
    MessageBox.Show(info.Location.ToString());
}

Private Sub HandleMouseDown(ByVal sender As Object, ByVal e As MouseEventArgs) _
        Handles Me.MouseDown, listView1.MouseDown

    Dim info As ListViewHitTestInfo = listView1.HitTest(e.X, e.Y)
    MessageBox.Show(info.Location.ToString())

End Sub

注釈

このメソッドを使用して、ポイントがアイテムまたはサブアイテム内にあるかどうか、およびラベルや画像領域など、ポイントが配置されているアイテム内の場所を判断します。 座標がコントロールの外部にある場合、返される ListViewHitTestInfo オブジェクトのプロパティは Location "None" で、 Item および SubItem プロパティは に null設定されます。