ListViewItem.FindNearestItem(SearchDirectionHint) Método

Definição

Espaço de Nomes:
System.Windows.Forms
Assemblagem:
System.Windows.Forms.dll
Origem:
ListViewItem.cs
Origem:
ListViewItem.cs
Origem:
ListViewItem.cs
Origem:
ListViewItem.cs
Origem:
ListViewItem.cs

Encontra o próximo item do ListViewItem, procurando na direção especificada.

public:
 System::Windows::Forms::ListViewItem ^ FindNearestItem(System::Windows::Forms::SearchDirectionHint searchDirection);
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

Parâmetros

searchDirection
SearchDirectionHint

Um dos SearchDirectionHint valores.

Devoluções

ListViewItem

O ListViewItem que é o mais próximo das coordenadas dadas, procurando na direção especificada.

Exceções

InvalidOperationException

A View propriedade do que contém ListView é definida para um valor diferente de SmallIcon ou LargeIcon.

Exemplos

O exemplo de código seguinte demonstra como usar o FindNearestItem método. Para executar este exemplo, cole o seguinte código num formulário Windows que contenha um ListView chamado findListView. Certifique-se de que a View propriedade está definida como uma vista de ícones e que está ListView preenchida com itens. Associe o MouseDown evento de findListView ao findListView_MouseDown método neste exemplo.

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

Observações

O FindNearestItem método retorna null se não for encontrado nenhum item na direção indicada.

A identificação do item mais próximo pode variar consoante o sistema operativo onde a aplicação está a correr e afetará os resultados de FindNearestItem.

Aplica-se a