次の方法で共有


ListView.HitTest メソッド

定義

指定した 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。 座標は、このコントロールの左上隅を起点とした相対座標です。

戻り値

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

例外

ポイントに、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 座標。 座標は、このコントロールの左上隅を起点とした相対座標です。

戻り値

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

例外

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

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

適用対象