ListView.SearchForVirtualItem Kejadian
Definisi
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.
Terjadi ketika ListView berada dalam mode virtual dan pencarian sedang berlangsung.
public:
event System::Windows::Forms::SearchForVirtualItemEventHandler ^ SearchForVirtualItem;
public event System.Windows.Forms.SearchForVirtualItemEventHandler SearchForVirtualItem;
public event System.Windows.Forms.SearchForVirtualItemEventHandler? SearchForVirtualItem;
member this.SearchForVirtualItem : System.Windows.Forms.SearchForVirtualItemEventHandler
Public Custom Event SearchForVirtualItem As SearchForVirtualItemEventHandler
Jenis Acara
Contoh
Contoh kode berikut menunjukkan penggunaan anggota ini. Dalam contoh, pencarian mengembalikan kecocokan terdekat dengan bilangan bulat tertentu dalam daftar sepuluh ribu kuadrat pertama. Contoh kode ini adalah bagian dari contoh yang lebih besar yang disediakan untuk VirtualMode properti .
//This event handler enables search functionality, and is called
//for every search request when in Virtual mode.
void listView1_SearchForVirtualItem(object sender, SearchForVirtualItemEventArgs e)
{
//We've gotten a search request.
//In this example, finding the item is easy since it's
//just the square of its index. We'll take the square root
//and round.
double x = 0;
if (Double.TryParse(e.Text, out x)) //check if this is a valid search
{
x = Math.Sqrt(x);
x = Math.Round(x);
e.Index = (int)x;
}
//If e.Index is not set, the search returns null.
//Note that this only handles simple searches over the entire
//list, ignoring any other settings. Handling Direction, StartIndex,
//and the other properties of SearchForVirtualItemEventArgs is up
//to this handler.
}
'This event handler enables search functionality, and is called
'for every search request when in Virtual mode.
Private Sub listView1_SearchForVirtualItem(ByVal sender As Object, ByVal e As SearchForVirtualItemEventArgs) Handles listView1.SearchForVirtualItem
'We've gotten a search request.
'In this example, finding the item is easy since it's
'just the square of its index. We'll take the square root
'and round.
Dim x As Double = 0
If [Double].TryParse(e.Text, x) Then 'check if this is a valid search
x = Math.Sqrt(x)
x = Math.Round(x)
e.Index = Fix(x)
End If
'Note that this only handles simple searches over the entire
'list, ignoring any other settings. Handling Direction, StartIndex,
'and the other properties of SearchForVirtualItemEventArgs is up
'to this handler.
End Sub
Keterangan
Peristiwa ini terjadi ketika ListView berada dalam mode virtual dan FindNearestItem metode atau FindItemWithText dipanggil. Saat menangani peristiwa ini, Anda harus menghitung item mana dari daftar item yang disediakan oleh properti yang cocok dengan Items kriteria pencarian dan mengatur SearchForVirtualItemEventArgs.Index properti ke indeks ListViewItem. Jika item tidak disediakan, FindNearestItem dan FindItemWithText akan mengembalikan null.
Untuk informasi selengkapnya tentang menangani peristiwa, lihat Menangani dan Meningkatkan Peristiwa.