LVM_GETISEARCHSTRING pesan

Artikel
06/13/2023

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

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Commctrl.h
Nama Unicode dan ANSI	LVM_GETISEARCHSTRINGW (Unicode) dan LVM_GETISEARCHSTRINGA (ANSI)