ListViewItem.FindNearestItem(SearchDirectionHint) Metode

Referensi

Definisi

Ruang nama:: System.Windows.Forms

Rakitan:: System.Windows.Forms.dll

Penting

Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.

Menemukan item berikutnya dari ListViewItem, mencari ke arah yang ditentukan.

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

Parameter

searchDirection: SearchDirectionHint

Salah SearchDirectionHint satu nilai.

Mengembalikan

ListViewItem

ListViewItem Yang paling dekat dengan koordinat yang diberikan, mencari ke arah yang ditentukan.

Pengecualian

InvalidOperationException

Properti View dari yang berisi ListView diatur ke nilai selain SmallIcon atau LargeIcon.

Contoh

Contoh kode berikut menunjukkan cara menggunakan FindNearestItem metode . Untuk menjalankan contoh ini, tempelkan kode berikut ke dalam Formulir Windows yang berisi bernama ListViewfindListView. Pastikan bahwa View properti diatur ke tampilan ikon dan ListView diisi dengan item. Kaitkan MouseDown peristiwa findListView dengan findListView_MouseDown metode dalam contoh ini.

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

Keterangan

Metode FindNearestItem mengembalikan null jika tidak ada item yang ditemukan dalam arah tertentu.

Mengidentifikasi item terdekat dapat bervariasi tergantung pada sistem operasi yang dijalankan aplikasi dan akan memengaruhi hasil FindNearestItem.

Berlaku untuk

Bagikan melalui