pesan LVM_SETITEM
Mengatur beberapa atau semua atribut item tampilan daftar. Anda juga dapat mengirim LVM_SETITEM untuk mengatur teks subitem. Anda dapat mengirim pesan ini secara eksplisit atau dengan menggunakan makro ListView_SetItem .
Parameter
-
wParam
- Harus nol.
-
lParam
-
Penunjuk ke struktur LVITEM yang berisi atribut item baru. Anggota iItem dan 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 anggota status berisi nilai untuk status tersebut.
Nilai kembali
Mengembalikan TRUE jika berhasil, atau FALSE sebaliknya.
Keterangan
Untuk mengatur atribut item tampilan daftar, atur anggota iItem dari struktur LVITEM ke indeks item, dan atur anggota iSubItem ke nol. Untuk item, Anda dapat mengatur status,pszText, iImage, dan anggota lParam dari struktur LVITEM .
Untuk mengatur teks subitem, atur anggota iItem dan 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
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Header |
|
Nama Unicode dan ANSI |
LVM_SETITEMW (Unicode) dan LVM_SETITEMA (ANSI) |