ListView_GetISearchString makro (commctrl.h)

Mendapatkan string pencarian inkremental dari kontrol tampilan daftar. Anda dapat menggunakan makro ini atau mengirim pesan LVM_GETISEARCHSTRING secara eksplisit.

Sintaksis

BOOL ListView_GetISearchString(
   HWND  hwndLV,
   LPSTR lpsz
);

Parameter

hwndLV

Jenis: HWND

Handel ke kontrol tampilan daftar.

lpsz

Jenis: LPSTR

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

Mengembalikan nilai

Jenis: BOOL

Mengembalikan jumlah karakter dalam string pencarian inkremental, atau nol jika kontrol tampilan daftar tidak dalam mode pencarian inkremental.

Komentar

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 akan 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 bertahap akan diatur ulang.

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

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h