This topic has not yet been rated - Rate this topic

ListViewHitTestLocations Enumeration

.NET Framework 4

Other Versions

Defines constants that represent areas in a ListView or ListViewItem.

This enumeration has a FlagsAttribute attribute that allows a bitwise combination of its member values.

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

Syntax

C++

Copy

[FlagsAttribute]
public enum ListViewHitTestLocations

Members

	Member name	Description
	None	A position outside the bounds of a ListViewItem
	AboveClientArea	A position above the client portion of a ListView control.
	BelowClientArea	A position below the client portion of a ListView control.
	LeftOfClientArea	A position to the left of the client portion of a ListView control.
	RightOfClientArea	A position to the right of the client portion of a ListView control.
	Image	A position within the bounds of an image contained in a ListView or ListViewItem.
	StateImage	A position within the bounds of an image associated with a ListViewItem that indicates the state of the item.
	Label	A position within the bounds of a text area contained in a ListView or ListViewItem.

Remarks

The ListViewHitTestLocations enumeration is used by the ListViewHitTestInfo class.

Examples

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

Copy


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

Version Information

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Platforms

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

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

Reference

System.Windows.Forms Namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Content Add

FAQ