ListViewItem.FindNearestItem(SearchDirectionHint) Metodo

Definizione

Spazio dei nomi:

System.Windows.Forms

Assembly:

System.Windows.Forms.dll

Individua l'elemento successivo nell'oggetto ListViewItem, cercando nella direzione indicata.

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

Parametri

searchDirection

SearchDirectionHint

Uno dei valori di SearchDirectionHint.

Restituisce

ListViewItem

Oggetto ListViewItem più prossimo alle coordinate indicate, nella direzione di ricerca specificata.

Eccezioni

InvalidOperationException

La proprietà View dell'oggetto ListView che la contiene è impostata su un valore diverso da SmallIcon o LargeIcon.

Esempio

Nell'esempio di codice riportato di seguito viene illustrato come utilizzare il metodo FindNearestItem. Per eseguire questo esempio, incollare il codice seguente in un Windows Form contenente un ListView oggetto denominato findListView. Assicurarsi che la View proprietà sia impostata su una visualizzazione icona e che l'oggetto ListView sia popolato con elementi. Associare l'evento MouseDown di findListView al findListView_MouseDown metodo in questo esempio.

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

Commenti

Il FindNearestItem metodo restituisce null se non viene trovato alcun elemento nella direzione specificata.

L'identificazione dell'elemento più vicino può variare a seconda del sistema operativo in cui è in esecuzione l'applicazione e influirà sui risultati di FindNearestItem.