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 |
|