ListView.FindNearestItem Method (SearchDirectionHint, Int32, Int32)


Finds the next item from the given x- and y-coordinates, searching in the specified direction.

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

public ListViewItem FindNearestItem(
	SearchDirectionHint searchDirection,
	int x,
	int y


Type: System.Windows.Forms.SearchDirectionHint

One of the SearchDirectionHint values.

Type: System.Int32

The x-coordinate for the point at which to begin searching.

Type: System.Int32

The y-coordinate for the point at which to begin searching.

Return Value

Type: System.Windows.Forms.ListViewItem

The ListViewItem that is closest to the given coordinates, searching in the specified direction.

Exception Condition

View is set to a value other than SmallIcon or LargeIcon.

The FindNearestItem method returns null if no item is found in the given direction. Identifying the nearest item can vary depending on the operating system the application is running on, and will affect the results of FindNearestItem.

.NET Framework
Available since 2.0
Return to top