ListViewItem.FindNearestItem(SearchDirectionHint) 方法

定义

命名空间:

System.Windows.Forms

程序集:

System.Windows.Forms.dll

从 ListViewItem 查找下一个项，按指定的方向搜索。

public:
 System::Windows::Forms::ListViewItem ^ FindNearestItem(System::Windows::Forms::SearchDirectionHint searchDirection);

public System.Windows.Forms.ListViewItem? FindNearestItem (System.Windows.Forms.SearchDirectionHint searchDirection);

member this.FindNearestItem : System.Windows.Forms.SearchDirectionHint -> System.Windows.Forms.ListViewItem

Public Function FindNearestItem (searchDirection As SearchDirectionHint) As ListViewItem

参数

searchDirection

SearchDirectionHint

SearchDirectionHint 值之一。

返回

ListViewItem

与给定坐标最接近的 ListViewItem（以指定方向进行搜索）。

例外

InvalidOperationException

作为容器的 View 的 ListView 属性被设置为除 SmallIcon 和 LargeIcon 以外的值。

示例

下面的代码示例演示如何使用 FindNearestItem 方法。 若要运行此示例，请将以下代码粘贴到包含名为 findListView的 ListView Windows 窗体中。 确保 属性 View 设置为图标视图， ListView 并且 已填充项。 将 MouseDown 的事件 findListView 与 findListView_MouseDown 此示例中的 方法相关联。

void findListView_MouseDown(object sender, MouseEventArgs e)
{
    ListViewHitTestInfo info = findListView.HitTest(e.X, e.Y);
    ListViewItem foundItem = null;
    if (info.Item != null)
        foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up);
    if (foundItem != null)
        label1.Text = "Previous Item: " + foundItem.Text;

    else
        label1.Text = "No item found";
}

Private Sub findListView_MouseDown(ByVal sender As Object, ByVal e As MouseEventArgs)


    Dim info As ListViewHitTestInfo = findListView.HitTest(e.X, e.Y)
    Dim foundItem As ListViewItem = Nothing
    If (info.Item IsNot Nothing) Then
        foundItem = info.Item.FindNearestItem(SearchDirectionHint.Up)
    End If
    If (foundItem IsNot Nothing) Then
        label1.Text = "Previous Item: " + foundItem.Text

    Else
        label1.Text = "No item found"
    End If

End Sub

注解

如果在给定方向上找不到任何项，则 FindNearestItem 方法返回 null 。

标识最近的项可能因运行应用程序的操作系统而异，并会影响 的结果 FindNearestItem。