ListViewItem.FindNearestItem(SearchDirectionHint) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Source:

ListViewItem.cs

Recherche l’élément suivant à partir de la ListViewItemrecherche dans la direction spécifiée.

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

Paramètres

searchDirection

SearchDirectionHint

Une des SearchDirectionHint valeurs.

Retours

ListViewItem

Le ListViewItem plus proche des coordonnées données, en recherchant dans la direction spécifiée.

Exceptions

InvalidOperationException

La View propriété du conteneur ListView est définie sur une valeur autre que SmallIcon ou LargeIcon.

Exemples

L’exemple de code suivant montre comment utiliser la FindNearestItem méthode. Pour exécuter cet exemple, collez le code suivant dans un Windows Form qui contient un ListView nom findListView. Vérifiez que la View propriété est définie sur une vue d’icône et que celle-ci ListView est remplie avec des éléments. Associez l’événement MouseDown de findListView la findListView_MouseDown méthode dans cet exemple.

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

Remarques

La FindNearestItem méthode retourne null si aucun élément n’est trouvé dans la direction donnée.

L’identification de l’élément le plus proche peut varier en fonction du système d’exploitation sur lequel l’application s’exécute et affectera les résultats de FindNearestItem.