ListViewItem.FindNearestItem(SearchDirectionHint) Méthode

Définition

Espace de noms:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Recherche l'élément suivant depuis ListViewItem, en recherchant 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 valeurs de l'objet SearchDirectionHint.

Retours

ListViewItem

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

Exceptions

InvalidOperationException

La propriété View de ListView contenant a une valeur autre que SmallIcon ou LargeIcon.

Exemples

L'exemple de code suivant illustre l'utilisation de la méthode FindNearestItem. Pour exécuter cet exemple, collez le code suivant dans un Windows Form qui contient un ListView nommé findListView. Vérifiez que la View propriété est définie sur un affichage d’icônes et que le ListView est rempli 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.