ListView.HitTest Method (Int32, Int32)

Provides item information, given x- and y-coordinates.

Namespace:  System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public ListViewHitTestInfo HitTest(
	int x,
	int y
)

Parameters

x
Type: System.Int32

The x-coordinate at which to retrieve the item information. The coordinate is relative to the upper-left corner of the control.

y
Type: System.Int32

The y-coordinate at which to retrieve the item information. The coordinate is relative to the upper-left corner of the control.

Return Value

Type: System.Windows.Forms.ListViewHitTestInfo
The item information, given x- and y- coordinates.

ExceptionCondition
ArgumentOutOfRangeException

The x- or y-coordinate is less than 0.

Use this method to determine whether a point is in an item or subitem, and where in the item the point is located, such as on the label or image area. If the coordinates are located outside the control, the returned ListViewHitTestInfo object has a Location property of "None"; and the Item and SubItem properties are set to null.

The following code example demonstrates using the HitTest method to determine the location of a mouse event in a ListView. To run this example, paste it into a Windows Form that contains a ListView named listView1 that is populated with items. Associate the MouseDown event for listView1 with the listView1_MouseDown method in this example.

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

.NET Framework

Supported in: 4.5.2, 4.5.1, 4.5, 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8.1, Windows Server 2012 R2, Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft