ListViewItem.FindNearestItem(SearchDirectionHint) Methode

Definition

Namespace:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Sucht nach dem nächsten Element von ListViewItem in der angegebenen Richtung.

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

Parameter

searchDirection

SearchDirectionHint

Einer der SearchDirectionHint-Werte.

Gibt zurück

ListViewItem

Das ListViewItem, das den angegebenen Koordinaten in der angegebenen Richtung am nächsten ist.

Ausnahmen

InvalidOperationException

Die View-Eigenschaft der enthaltenden ListView wird auf einen anderen Wert als SmallIcon oder LargeIcon festgelegt.

Beispiele

Das folgende Codebeispiel zeigt, wie Sie die FindNearestItem-Methode verwenden. Fügen Sie zum Ausführen dieses Beispiels den folgenden Code in eine Windows Form ein, die einen ListView mit dem Namen findListViewenthält. Stellen Sie sicher, dass die View -Eigenschaft auf eine Symbolansicht festgelegt ist und dass die ListView mit Elementen aufgefüllt wird. Ordnen Sie das MouseDown -Ereignis von findListView der findListView_MouseDown -Methode in diesem Beispiel zu.

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

Hinweise

Die FindNearestItem -Methode gibt zurück null , wenn kein Element in der angegebenen Richtung gefunden wird.

Die Identifizierung des nächsten Elements kann je nach Betriebssystem variieren, unter dem die Anwendung ausgeführt wird, und wirkt sich auf die Ergebnisse von aus FindNearestItem.