LVM_GETISEARCHSTRING pesan

Mengambil string pencarian inkremental dari kontrol tampilan daftar. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_GetISearchString .

Parameter

wParam

Harus nol.

lParam

Penunjuk ke buffer yang menerima string pencarian inkremental. Untuk hanya mengambil panjang string, atur lParam ke NULL.

Nilai kembali

Mengembalikan jumlah karakter dalam string pencarian bertahap, tidak termasuk karakter NULL yang mengakhiri, atau nol jika kontrol tampilan daftar tidak dalam mode pencarian inkremental.

Keterangan

Peringatan Keamanan: Menggunakan pesan ini secara tidak benar dapat membahayakan keamanan program Anda. Pesan ini tidak menyediakan cara bagi Anda untuk mengetahui ukuran buffer. Jika Anda menggunakan pesan ini, pertama-tama panggil pesan yang meneruskan NULL di lParam, ini mengembalikan jumlah karakter, tidak termasuk NULL yang diperlukan. Kemudian panggil pesan untuk kedua kalinya untuk mengambil string. Anda harus meninjau Pertimbangan Keamanan: Kontrol Microsoft Windows sebelum melanjutkan.

String pencarian inkremental adalah urutan karakter yang jenis pengguna sementara tampilan daftar memiliki fokus input. Setiap kali pengguna mengetik karakter, sistem menambahkan karakter ke string pencarian lalu mencari item yang cocok. Jika sistem menemukan kecocokan, sistem memilih item dan, jika perlu, menggulirnya ke tampilan.

Periode waktu habis dikaitkan dengan setiap karakter yang jenis pengguna. Jika periode waktu habis berlalu sebelum pengguna mengetik karakter lain, string pencarian inkremental diatur ulang.

Pastikan bahwa buffer cukup besar untuk menahan string dan karakter NULL yang mengakhiri. Jika terlalu kecil, kesalahan halaman segera yang tidak valid akan dihasilkan.

Persyaratan