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 的坐标。

注解

使用此方法可确定某个点是否位于项或子项中，以及该点在项中的位置，例如在标签或图像区域。 如果坐标位于 控件外部，则返回的对象具有Location属性“None”;并且 和 ItemSubItem 属性设置为 null。ListViewHitTestInfo

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的位置。 若要运行此示例，请将其粘贴到包含 ListView 用项目填充的名为 listView1 的 Windows 窗体中。 将 MouseDown 的事件 listView1 与 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

注解

使用此方法可确定某个点是否位于项或子项中，以及该点在项中的位置，例如在标签或图像区域。 如果坐标位于 控件外部，则返回的对象具有Location属性“None”;并且 和 ItemSubItem 属性设置为 null。ListViewHitTestInfo