ListView.HitTest メソッド

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

パラメーター

戻り値

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

例外

注釈

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

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 座標と y 座標の項目情報。

例外

例

次のコード例では、 メソッドを 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設定されます。