ListView.FindNearestItem Method (SearchDirectionHint, Int32, Int32) (System.Windows.Forms)

Switch View :

Classic

Lightweight

ScriptFree

Site Feedback

.NET Framework Class Library

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)

Syntax

Visual Basic

Public Function FindNearestItem ( _
	searchDirection As SearchDirectionHint, _
	x As Integer, _
	y As Integer _
) As ListViewItem

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

Visual C++

public:
ListViewItem^ FindNearestItem(
	SearchDirectionHint searchDirection, 
	int x, 
	int y
)

member FindNearestItem : 
        searchDirection:SearchDirectionHint * 
        x:int * 
        y:int -> ListViewItem

Parameters

searchDirection: Type: System.Windows.Forms.SearchDirectionHint
One of the SearchDirectionHint values.

x: Type: System.Int32
The x-coordinate for the point at which to begin searching.

y: 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.

Exceptions

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

Remarks

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.

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

ListView Class

FindNearestItem Overload

System.Windows.Forms Namespace