ListViewHitTestLocations Enumeration

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

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)

[FlagsAttribute]
public enum ListViewHitTestLocations

Member nameDescription
AboveClientArea

A position above the client portion of a ListView control.

BelowClientArea

A position below the client portion of a ListView control.

Image

A position within the bounds of an image contained in a ListView or ListViewItem.

Label

A position within the bounds of a text area contained in a ListView or ListViewItem.

LeftOfClientArea

A position to the left of the client portion of a ListView control.

None

A position outside the bounds of a ListViewItem

RightOfClientArea

A position to the right of the client portion of a ListView control.

StateImage

A position within the bounds of an image associated with a ListViewItem that indicates the state of the item.

The ListViewHitTestLocations enumeration is used by the ListViewHitTestInfo class.

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.

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

.NET Framework
Available since 2.0
Return to top
Show: