Bagikan melalui


LVM_SETITEMCOUNT pesan

Menyebabkan kontrol tampilan daftar mengalokasikan memori untuk jumlah item yang ditentukan atau mengatur jumlah virtual item dalam kontrol tampilan daftar virtual.

Parameter

wParam

Jumlah item yang pada akhirnya akan dimuat oleh kontrol tampilan daftar.

lParam

Versi 4.70. Nilai yang menentukan perilaku kontrol tampilan daftar setelah mengatur ulang jumlah item. Nilai ini bisa menjadi kombinasi dari yang berikut ini:

Nilai Makna
LVSICF_NOINVALIDATEALL
Kontrol tampilan daftar tidak akan dicat ulang kecuali item yang terpengaruh saat ini sedang dalam tampilan.
LVSICF_NOSCROLL
Kontrol tampilan daftar tidak akan mengubah posisi gulir saat jumlah item berubah.

Nilai kembali

Mengembalikan bukan nol jika berhasil, atau nol sebaliknya.

Keterangan

Bagaimana memori dialokasikan tergantung pada bagaimana kontrol tampilan daftar dibuat. Anda dapat mengirim pesan ini secara eksplisit atau menggunakan makro ListView_SetItemCount atau ListView_SetItemCountEx . Untuk informasi selengkapnya, lihat Gaya List-View Virtual.

Jika kontrol tampilan daftar dibuat tanpa gaya LVS_OWNERDATA , mengirim pesan ini menyebabkan kontrol mengalokasikan struktur data internalnya untuk jumlah item yang ditentukan. Ini mencegah kontrol harus mengalokasikan struktur data setiap kali item ditambahkan.

Jika kontrol tampilan daftar dibuat dengan gaya LVS_OWNERDATA (tampilan daftar virtual), mengirim pesan ini mengatur jumlah item virtual yang dikandung kontrol.

Parameter lParam hanya ditujukan untuk kontrol tampilan daftar yang menggunakan gaya LVS_OWNERDATA dan LVS_REPORT atau LVS_LIST .

Ketika tampilan daftar kontrol umum adalah tampilan daftar virtual (LVS_OWNERDATA), ada batas 100.000.000 item pada tampilan daftar. Dalam skenario ini, LVM_SETITEMCOUNT akan mengembalikan FALSE ketika memiliki wParam 100.000.001.

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