ListViewItem.FindNearestItem(SearchDirectionHint) Yöntem

Tanım

Ad Alanı:

System.Windows.Forms

Bütünleştirilmiş Kod:

System.Windows.Forms.dll

Kaynak:

ListViewItem.cs

içinde belirtilen yönde arama yaparak bir sonraki öğeyi ListViewItembulur.

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

Parametreler

searchDirection

SearchDirectionHint

Değerlerden SearchDirectionHint biri.

Döndürülenler

ListViewItem

ListViewItem Belirtilen koordinatlara en yakın olan, belirtilen yönde arama.

Özel durumlar

InvalidOperationException

View öğesini içeren ListView özelliği veya LargeIcondışında SmallIcon bir değere ayarlanır.

Örnekler

Aşağıdaki kod örneğinde yönteminin nasıl kullanılacağı gösterilmektedir FindNearestItem . Bu örneği çalıştırmak için, aşağıdaki kodu adlı findListViewbir içeren ListView windows formuna yapıştırın. özelliğinin View simge görünümüne ayarlandığından ve öğesinin ListView öğelerle dolduruldığından emin olun. MouseDown olayını findListView bu örnekteki findListView_MouseDown yöntemiyle ilişkilendirin.

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

Açıklamalar

Yöntemi, FindNearestItem verilen yönde hiçbir öğe bulunamazsa döndürür null .

En yakın öğeyi tanımlamak, uygulamanın üzerinde çalıştığı işletim sistemine bağlı olarak değişebilir ve sonuçlarını FindNearestItemetkiler.