ListView_SetItem makro (commctrl.h)

2024-10-24

Mengatur beberapa atau semua atribut item tampilan daftar. Anda juga dapat menggunakan ListView_SetItem untuk mengatur teks subitem. Anda dapat menggunakan makro ini atau mengirim pesan LVM_SETITEM secara eksplisit.

Sintaksis

BOOL ListView_SetItem(
         HWND     hwnd,
   const LPLVITEM pitem
);

Parameter

hwnd

Jenis: HWND

Handel ke kontrol tampilan daftar.

pitem

Jenis: const LPLVITEM

Penunjuk ke struktur LVITEM yang berisi atribut item baru. iItem dan anggota iSubItem mengidentifikasi item atau subitem, dan anggota mask menentukan atribut mana yang akan diatur. Jika anggota mask menentukan nilai LVIF_TEXT, anggota pszText adalah alamat string yang dihentikan null dan anggota cchTextMax diabaikan. Jika anggota mask menentukan nilai LVIF_STATE, anggota stateMask menentukan status item mana yang akan diubah, dan status anggota berisi nilai untuk status tersebut.

Mengembalikan nilai

Jenis: BOOL

Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.

Komentar

Untuk mengatur atribut item tampilan daftar, atur iItem anggota LVITEM ke indeks item, dan atur anggota iSubItem ke nol. Untuk item, Anda dapat menggunakan status , pszText, iImage, dan lParam anggota LVITEM untuk memodifikasi parameter item ini.

Untuk mengatur teks subitem, atur iItem dan anggota iSubItem untuk menunjukkan subitem tertentu, dan gunakan anggota pszText untuk menentukan teks. Atau, Anda dapat menggunakan makro ListView_SetItemText untuk mengatur teks subitem. Anda tidak dapat mengatur status atau anggota lParam untuk subitem karena subitem tidak memiliki atribut ini. Di versi 4.70 dan yang lebih baru, Anda dapat mengatur anggota iImage untuk subitem. Gambar subitem akan ditampilkan jika kontrol tampilan daftar memiliki gaya LVS_EX_SUBITEMIMAGES diperluas. Versi sebelumnya akan mengabaikan gambar subitem.

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