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

注解

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

适用于

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

适用于