TreeView_GetISearchString makro (commctrl.h)

Mengambil string pencarian inkremental untuk kontrol tampilan pohon. Kontrol tampilan pohon menggunakan string pencarian inkremental untuk memilih item berdasarkan karakter yang diketik oleh pengguna. Anda dapat menggunakan makro ini atau mengirim pesan TVM_GETISEARCHSTRING secara eksplisit.

Sintaksis

BOOL TreeView_GetISearchString(
   HWND   hwndTV,
   LPTSTR lpsz
);

Parameter

hwndTV

Jenis: HWND

Tangani ke kontrol tampilan pohon.

lpsz

Jenis: LPTSTR

Penunjuk ke buffer yang menerima string pencarian inkremental.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika string diambil; FALSE sebaliknya.

Komentar

Peringatan Keamanan: Menggunakan makro ini salah dapat membahayakan keamanan program Anda. Anda harus mengalokasikan buffer yang cukup besar untuk menahan string. Pertama, panggil makro yang melewati NULL di lpsz. Ini mengembalikan jumlah karakter, tidak termasuk NULL, yang diperlukan. Kemudian panggil makro untuk kedua kalinya untuk mengambil string. Anda harus meninjau Pertimbangan Keamanan: Microsoft Windows Controls sebelum melanjutkan.

Jika kontrol tampilan pohon tidak dalam mode pencarian inkremental, nilai yang dikembalikan adalah nol.

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