ListView_InsertItem makro (commctrl.h)

2024-10-24

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

Sintaksis

int ListView_InsertItem(
         HWND     hwnd,
   const LPLVITEM 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

Jenis: int

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

Komentar

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 dari status anggota struktur LVITEM akan diabaikan. Ketika item ditambahkan dengan kumpulan 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 pszText anggota struktur LVITEM-nya.

Makro ListView_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 ditunjukkan oleh pitem tidak diatur ke LPSTR_TEXTCALLBACK.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	commctrl.h

Bagikan melalui