pesan CB_ADDSTRING

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

Parameter

wParam

Parameter ini tidak digunakan.

lParam

Penunjuk LPCTSTR ke string yang dihentikan null untuk ditambahkan. Jika Anda membuat kotak kombo dengan gaya yang digambar pemilik tetapi tanpa gaya CBS_HASSTRINGS , nilai parameter lParam disimpan sebagai data item daripada string yang akan ditunjukkannya. Data item dapat diambil atau dimodifikasi dengan mengirim pesan CB_GETITEMDATA atau CB_SETITEMDATA .

Nilai kembali

Nilai yang dikembalikan adalah indeks berbasis nol ke string dalam kotak daftar kotak kombo. Jika terjadi kesalahan, nilai yang dikembalikan adalah CB_ERR. Jika tidak tersedia cukup ruang untuk menyimpan string baru, maka akan CB_ERRSPACE.

Keterangan

Jika Anda membuat kotak kombo yang digambar pemilik dengan gaya CBS_SORT tetapi tanpa gaya CBS_HASSTRINGS , pesan WM_COMPAREITEM dikirim satu atau beberapa kali ke pemilik kotak kombo sehingga item baru dapat ditempatkan dengan benar dalam daftar.

Untuk menyisipkan string di lokasi tertentu dalam daftar, gunakan pesan CB_INSERTSTRING .

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

Comclt32.dll versi 5.0 atau yang lebih baru: Jika CBS_LOWERCASE atau CBS_UPPERCASE diatur, versi Unicode CB_ADDSTRING mengubah string. Jika menggunakan memori global baca-saja, ini menyebabkan aplikasi gagal.

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

CB_DIR

CB_INSERTSTRING

LB_SETHORIZONTALEXTENT

WM_COMPAREITEM