pesan LB_SELECTSTRING

Mencari kotak daftar untuk item yang dimulai dengan karakter dalam string tertentu. Jika item yang cocok ditemukan, item dipilih.

Parameter

wParam

Indeks berbasis nol item sebelum item pertama yang akan dicari. Saat pencarian mencapai bagian bawah kotak daftar, pencarian berlanjut dari bagian atas kotak daftar kembali ke item yang ditentukan oleh parameter wParam . Jika wParam adalah -1, seluruh kotak daftar dicari dari awal.

Windows 95/Windows 98/Windows Millennium Edition (Windows Me) : Parameter wParam dibatasi hingga nilai 16-bit. Ini berarti kotak daftar tidak boleh berisi lebih dari 32.767 item. Meskipun jumlah item dibatasi, ukuran total dalam byte item dalam kotak daftar hanya dibatasi oleh memori yang tersedia.

lParam

Penunjuk ke string yang dihentikan null yang berisi awalan yang akan dicari. Pencarian tidak bergantung pada huruf besar/kecil, sehingga string ini dapat berisi kombinasi huruf besar dan huruf kecil.

Nilai kembali

Jika pencarian berhasil, nilai yang dikembalikan adalah indeks item yang dipilih. Jika pencarian tidak berhasil, nilai yang dikembalikan LB_ERR dan pilihan saat ini tidak diubah.

Keterangan

Kotak daftar digulir, jika perlu, untuk menampilkan item yang dipilih.

Jangan gunakan pesan ini dengan kotak daftar yang memiliki LBS_MULTIPLESEL atau gaya LBS_EXTENDEDSEL .

Item dipilih hanya jika karakter awalnya dari titik awal cocok dengan karakter dalam string yang ditentukan oleh parameter lParam .

Jika kotak daftar memiliki gaya yang digambar pemilik tetapi bukan gaya LBS_HASSTRINGS , tindakan yang diambil oleh LB_SELECTSTRING bergantung pada apakah gaya LBS_SORT digunakan. Jika LBS_SORT digunakan, sistem mengirim pesan WM_COMPAREITEM ke pemilik kotak daftar untuk menentukan item mana yang cocok dengan string yang ditentukan. Jika tidak, LB_SELECTSTRING mencoba menemukan item yang memiliki nilai panjang (disediakan sebagai parameter lParam dari pesan LB_ADDSTRING atau LB_INSERTSTRING ) yang cocok dengan parameter lParam .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Header	Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

LB_ADDSTRING

LB_FINDSTRING

LB_INSERTSTRING