ListViewItem.FindNearestItem(SearchDirectionHint) Methode

Definitie

Naamruimte:
System.Windows.Forms
Assembly:
System.Windows.Forms.dll

Hiermee zoekt u het volgende item uit de ListViewItem, zoekt u in de opgegeven richting.

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

Parameters

searchDirection
SearchDirectionHint

Een van de SearchDirectionHint waarden.

Retouren

ListViewItem

De ListViewItem gegevens die het dichtst bij de opgegeven coördinaten liggen, zoeken in de opgegeven richting.

Uitzonderingen

InvalidOperationException

De View eigenschap van het bestand ListView is ingesteld op een andere waarde dan SmallIcon of LargeIcon.

Voorbeelden

In het volgende codevoorbeeld ziet u hoe u de FindNearestItem methode gebruikt. Als u dit voorbeeld wilt uitvoeren, plakt u de volgende code in een Windows formulier dat een ListView met de naam findListView bevat. Zorg ervoor dat de View eigenschap is ingesteld op een pictogramweergave en of de ListView eigenschap is gevuld met items. Koppel de MouseDown gebeurtenis van findListView de findListView_MouseDown methode in dit voorbeeld.

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

Opmerkingen

De FindNearestItem methode retourneert null als er geen item in de opgegeven richting wordt gevonden.

Het identificeren van het dichtstbijzijnde item kan variëren, afhankelijk van het besturingssysteem waarop de toepassing wordt uitgevoerd en van invloed is op de resultaten van FindNearestItem.

Van toepassing op