ListViewItem.FindNearestItem(SearchDirectionHint) Metod

Definition

Namnområde:
System.Windows.Forms
Sammansättning:
System.Windows.Forms.dll
Källa:
ListViewItem.cs
Källa:
ListViewItem.cs
Källa:
ListViewItem.cs
Källa:
ListViewItem.cs
Källa:
ListViewItem.cs

Söker efter nästa objekt från ListViewItemoch söker i den angivna riktningen.

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

Parametrar

searchDirection
SearchDirectionHint

Ett av SearchDirectionHint värdena.

Returer

ListViewItem

Det ListViewItem som är närmast de angivna koordinaterna söker i den angivna riktningen.

Undantag

InvalidOperationException

Egenskapen View för innehållet ListView är inställd på ett annat värde än SmallIcon eller LargeIcon.

Exempel

I följande kodexempel visas hur du använder FindNearestItem metoden. Om du vill köra det här exemplet klistrar du in följande kod i ett Windows formulär som innehåller en ListView med namnet findListView. Kontrollera att egenskapen View är inställd på en ikonvy och att den ListView är ifylld med objekt. Associera händelsen MouseDownfindListView med findListView_MouseDown metoden i det här exemplet.

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

Kommentarer

Metoden FindNearestItem returnerar null om inget objekt hittas i den angivna riktningen.

Att identifiera närmaste objekt kan variera beroende på vilket operativsystem programmet körs på och påverkar resultatet av FindNearestItem.

Gäller för