NM_CUSTOMDRAW (tampilan daftar) kode pemberitahuan

  • Artikel

Dikirim oleh kontrol tampilan daftar untuk memberi tahu jendela induknya tentang operasi menggambar. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY .

NM_CUSTOMDRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

Parameter

lParam

Penunjuk ke struktur NMLVCUSTOMDRAW yang berisi informasi tentang operasi menggambar. Anggota pertama dari struktur ini, nmcd, adalah penunjuk ke struktur NMCUSTOMDRAW . Anggota dwItemSpec dari struktur yang diarahkan oleh nmcd berisi pengidentifikasi item yang digambar dan anggota lItemlParam berisi data yang ditentukan aplikasinya.

Menampilkan nilai

Nilai yang dapat dikembalikan aplikasi Anda tergantung pada tahap gambar saat ini. Anggota dwDrawStage dari struktur NMCUSTOMDRAW terkait memegang nilai yang menentukan tahap gambar. Anda harus mengembalikan salah satu nilai berikut.

Menampilkan kode Deskripsi
CDRF_DODEFAULT
 Kontrol akan menggambar dirinya sendiri. Ini tidak akan mengirim kode pemberitahuan NM_CUSTOMDRAW tambahan untuk siklus cat ini. Ini terjadi ketika dwDrawStage sama dengan CDDS_PREPAINT.
CDRF_DOERASE
 Windows Vista. Kontrol hanya akan melukis latar belakang.
CDRF_NOTIFYITEMDRAW
 Kontrol akan memberi tahu induk operasi gambar terkait item apa pun. Ini akan mengirim kode pemberitahuan NM_CUSTOMDRAW sebelum dan sesudah menggambar item. Ini terjadi ketika dwDrawStage sama dengan CDDS_PREPAINT.
CDRF_NOTIFYPOSTERASE
 Kontrol akan memberi tahu induk setelah menghapus item. Ini terjadi ketika dwDrawStage sama dengan CDDS_PREPAINT.
CDRF_NOTIFYPOSTPAINT
 Kontrol akan memberi tahu induk setelah melukis item. Ini terjadi ketika dwDrawStage sama dengan CDDS_PREPAINT.
CDRF_NEWFONT
 Aplikasi menentukan font baru untuk item; kontrol akan menggunakan font baru. Untuk informasi selengkapnya tentang mengubah font, lihat Mengubah font dan warna. Ini terjadi ketika dwDrawStage sama dengan CDDS_ITEMPREPAINT.
CDRF_NOTIFYSUBITEMDRAW
 Versi 4.71. Aplikasi Anda akan menerima kode kontrol NM_CUSTOMDRAW dengan dwDrawStage diatur ke CDDS_ITEMPREPAINT | CDDS_SUBITEM sebelum setiap subitem tampilan daftar digambar. Anda kemudian dapat menentukan font dan warna untuk setiap subitem secara terpisah atau mengembalikan CDRF_DODEFAULT untuk pemrosesan default. Ini terjadi ketika dwDrawStage sama dengan CDDS_ITEMPREPAINT.
CDRF_SKIPDEFAULT
 Aplikasi menggambar item secara manual. Kontrol tidak akan menggambar item. Ini terjadi ketika dwDrawStage sama dengan CDDS_ITEMPREPAINT.
CDRF_SKIPPOSTPAINT
 Windows Vista. Kontrol tidak akan menggambar persegi panjang fokus.

Keterangan

Versi 5.80. Jika Anda mengubah font dengan mengembalikan CDRF_NEWFONT, kontrol tampilan daftar mungkin menampilkan teks yang dipotong. Perilaku ini diperlukan untuk kompatibilitas mundur dengan versi kontrol umum yang lebih lama. Jika Anda ingin mengubah font kontrol tampilan daftar, Anda akan mendapatkan hasil yang lebih baik jika Anda mengirim pesan CCM_SETVERSION dengan nilai wParam diatur ke 5 sebelum menambahkan item apa pun ke kontrol.

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