LB_ADDSTRING pesan

Menambahkan string ke kotak daftar. Jika kotak daftar tidak memiliki gaya LBS_SORT , string ditambahkan ke akhir daftar. Jika tidak, string disisipkan ke dalam daftar dan daftar diurutkan.

Parameter

wParam

Parameter ini tidak digunakan.

lParam

Penunjuk ke string yang dihentikan null yang akan ditambahkan.

Jika kotak daftar memiliki gaya yang digambar pemilik tetapi bukan gaya LBS_HASSTRINGS , parameter ini disimpan sebagai data item, bukan string. Anda dapat mengirim pesan LB_GETITEMDATA dan LB_SETITEMDATA untuk mengambil atau mengubah data item.

Nilai kembali

Nilai yang dikembalikan adalah indeks berbasis nol dari string dalam kotak daftar. Jika terjadi kesalahan, nilai yang dikembalikan LB_ERR. Jika tidak ada cukup ruang untuk menyimpan string baru, nilai yang dikembalikan LB_ERRSPACE.

Keterangan

Jika kotak daftar memiliki gaya yang digambar pemilik dan gaya LBS_SORT , tetapi bukan gaya LBS_HASSTRINGS , sistem mengirim pesan WM_COMPAREITEM satu atau beberapa kali ke pemilik kotak daftar untuk menempatkan item baru dengan benar di kotak daftar.

Pesan LB_INITSTORAGE membantu mempercepat inisialisasi kotak daftar yang memiliki sejumlah besar item (lebih dari 100). Ini mencadangkan jumlah memori yang ditentukan sehingga pesan LB_ADDSTRING berikutnya membutuhkan waktu sesingkat mungkin. Anda dapat menggunakan perkiraan untuk parameter wParam dan lParam . Jika Anda terlalu berlebihan, memori tambahan dialokasikan; jika Anda meremehkan, alokasi normal digunakan untuk item yang melebihi jumlah yang diminta.

Jika kotak daftar memiliki gaya WS_HSCROLL dan Anda menambahkan string yang lebih lebar dari kotak daftar, kirim pesan LB_SETHORIZONTALEXTENT untuk memastikan bilah gulir horizontal muncul.

Untuk aplikasi ANSI, sistem mengonversi teks dalam kotak daftar ke Unicode menggunakan CP_ACP. Hal ini dapat menyebabkan masalah. Misalnya, karakter Romawi beraksen dalam kotak daftar non-Unicode di Windows Jepang akan keluar kacau. Untuk memperbaikinya, kompilasi aplikasi sebagai Unicode atau gunakan kotak daftar yang digambar pemilik.

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_DELETESTRING

LB_INSERTSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM