ListView_InsertItem makro (commctrl.h)

  • Artikel

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

Sintaks

void ListView_InsertItem(
   hwnd,
   pitem
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

pitem

Jenis: const LPLVITEM

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 kontrol tampilan daftar, item baru akan ditambahkan ke akhir daftar dan diberi indeks yang benar. Periksa nilai pengembalian makro untuk menentukan indeks aktual yang ditetapkan ke item.

Mengembalikan nilai

Tidak ada

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 anggota pszText dari struktur LVITEM-nya .

Makro ListView_InsertItem akan menyisipkan item baru dalam posisi yang tepat dalam urutan pengurutan jika kondisi berikut ini menahan:

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

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header commctrl.h