ListViewItem.FindNearestItem(SearchDirectionHint) Metoda

Definice

Obor názvů:

System.Windows.Forms

Sestavení:

System.Windows.Forms.dll

Vyhledá další položku z objektu ListViewItema hledá v zadaném směru.

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

Parametry

searchDirection

SearchDirectionHint

Jedna z SearchDirectionHint hodnot.

Návraty

ListViewItem

Hodnota ListViewItem , která je nejblíže zadaným souřadnicům a hledá se v zadaném směru.

Výjimky

InvalidOperationException

Vlastnost View obsahujícího ListView objektu je nastavena na jinou hodnotu než SmallIcon nebo LargeIcon.

Příklady

Následující příklad kódu ukazuje, jak použít metodu FindNearestItem . Chcete-li spustit tento příklad, vložte následující kód do formuláře windows, který obsahuje ListView s názvem findListView. Ujistěte se View , že je vlastnost nastavená na zobrazení ikony a že ListView je naplněna položkami. Přidružte MouseDown událost k findListView metodě v tomto příkladu findListView_MouseDown .

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

Poznámky

Metoda FindNearestItem vrátí hodnotu null , pokud není nalezena žádná položka v daném směru.

Identifikace nejbližší položky se může lišit v závislosti na operačním systému, ve kterém aplikace běží, a bude mít vliv na výsledky .FindNearestItem