This documentation is archived and is not being maintained.

ListView.HitTest Method (Int32, Int32)

Note: This method is new in the .NET Framework version 2.0.

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
)
public ListViewHitTestInfo HitTest (
	int x, 
	int y
)
public function HitTest (
	x : int, 
	y : int
) : ListViewHitTestInfo

Parameters

x

The x-coordinate at which to retrieve the item information.

y

The y-coordinate at which to retrieve the item information.

Return Value

A ListViewHitTestInfo.

Exception typeCondition

ArgumentOutOfRangeException

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

Use this method to determine if a point is in an item or subitem and where within the item the point is located, such as on the label or image area.

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());
}

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

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

.NET Framework

Supported in: 2.0
Show: