LB_INSERTSTRING pesan

Menyisipkan data string atau item ke dalam kotak daftar. Tidak seperti pesan LB_ADDSTRING , pesan LB_INSERTSTRING tidak menyebabkan daftar dengan gaya LBS_SORT diurutkan.

Parameter

wParam

Indeks berbasis nol dari posisi untuk menyisipkan string. Jika parameter ini adalah -1, string ditambahkan ke akhir daftar.

lParam

Penunjuk ke string yang dihentikan null untuk disisipkan. 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 posisi di mana string disisipkan. Jika terjadi kesalahan, nilai yang dikembalikan adalah LB_ERR. Jika tidak ada cukup ruang untuk menyimpan string baru, nilai yang dikembalikan akan LB_ERRSPACE.

Keterangan

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_INSERTSTRING 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 menyisipkan 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_ADDSTRING

LB_SELECTSTRING

LB_SETHORIZONTALEXTENT