LVM_INSERTITEM pesan

  • Artikel

Menyisipkan item baru dalam kontrol tampilan daftar. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_InsertItem .

Parameter

wParam

Harus nol.

lParam

Penunjuk ke struktur LVITEM yang menentukan atribut item tampilan daftar. Gunakan anggota iItem untuk menentukan indeks berbasis nol tempat item baru harus disisipkan. Jika nilai ini lebih besar dari jumlah item yang saat ini dimuat oleh tampilan daftar, item baru akan ditambahkan ke akhir daftar dan diberi indeks yang benar. Periksa nilai pengembalian pesan untuk menentukan indeks aktual yang ditetapkan ke item.

Nilai kembali

Mengembalikan indeks item baru jika berhasil, atau -1 jika tidak.

Keterangan

Anda tidak dapat menggunakan ListView_InsertItem atau LVM_INSERTITEM untuk menyisipkan subitem. Anggota iSubItem dari struktur LVITEM harus nol. Lihat LVM_SETITEM untuk informasi tentang pengaturan subitem.

Jika kontrol tampilan daftar memiliki kumpulan gaya LVS_EX_CHECKBOXES , nilai apa pun yang ditempatkan di bit 12 hingga 15 anggota status struktur LVITEM akan diabaikan. Ketika item ditambahkan dengan set gaya ini, item akan selalu diatur ke status tidak dicentang.

Jika kontrol tampilan daftar memiliki gaya jendela LVS_SORTASCENDING atau LVS_SORTDESCENDING , pesan LVM_INSERTITEM akan gagal jika Anda mencoba menyisipkan item yang memiliki LPSTR_TEXTCALLBACK sebagai nilai untuk anggota pszText-nya .

Pesan LVM_INSERTITEM akan menyisipkan item baru dalam posisi yang tepat dalam urutan pengurutan jika kondisi berikut ini ditangguhkan:

  • Anda menggunakan salah satu gaya LVS_SORTXXX.
  • Anda tidak menggunakan gaya LVS_OWNERDRAW .
  • Anggota pszText dari struktur yang ditujukkan oleh pitem tidak diatur ke LPSTR_TEXTCALLBACK.

Jika struktur LVITEM tidak berisi LVIF_GROUPID di anggota masker , nilai anggota iGroupId I_GROUPIDCALLBACK secara default.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
 Windows Server 2003 [hanya aplikasi desktop]
Header
Commctrl.h
Nama Unicode dan ANSI
 LVM_INSERTITEMW (Unicode) dan LVM_INSERTITEMA (ANSI)