NM_CUSTOMDRAW kode pemberitahuan

Artikel
06/13/2023

Memberi tahu jendela induk kontrol tentang operasi gambar kustom. Kode pemberitahuan ini dikirim dalam bentuk pesan WM_NOTIFY .

NM_CUSTOMDRAW

#ifdef LIST_VIEW_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMLVCUSTOMDRAW) lParam;

#elif TOOL_TIPS_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTTCUSTOMDRAW) lParam;

#elif TREE_VIEW_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTVCUSTOMDRAW) lParam;

#elif TOOL_BAR_CUSTOM_DRAW

    lpNMCustomDraw = (LPNMTBCUSTOMDRAW) lParam;

#else

    lpNMCustomDraw = (LPNMCUSTOMDRAW) lParam;

#endif

Parameter

lParam

Penunjuk ke struktur terkait gambar kustom yang berisi informasi tentang operasi menggambar. Daftar berikut menentukan kontrol dan struktur terkaitnya.

Kontrol	Struktur Gambar Kustom
Bilah ulang, bilah trek, dan header	NMCUSTOMDRAW
Tampilan daftar	NMLVCUSTOMDRAW
Tipsalat	NMTTCUSTOMDRAW
Pemandangan pohon	NMTVCUSTOMDRAW
Toolbar	NMTBCUSTOMDRAW

Mengembalikan 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. Bendera ini tidak dapat digunakan dengan bendera lain.
CDRF_DOERASE	Kontrol hanya akan menggambar latar belakang.
CDRF_NEWFONT	Aplikasi Anda 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_NOTIFYITEMDRAW	Kontrol akan memberi tahu induk dari setiap operasi gambar terkait item. 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 mengirim kode pemberitahuan NM_CUSTOMDRAW ketika siklus pengecatan untuk seluruh kontrol selesai. Ini terjadi ketika dwDrawStage sama dengan CDDS_PREPAINT.
CDRF_NOTIFYSUBITEMDRAW	Aplikasi Anda akan menerima kode pemberitahuan 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 Anda menggambar item secara manual. Kontrol tidak akan menggambar item. Ini terjadi ketika dwDrawStage sama dengan CDDS_ITEMPREPAINT.
CDRF_SKIPPOSTPAINT	Kontrol tidak akan menggambar persegi fokus di sekitar item.

Keterangan

Saat ini, kontrol berikut mendukung fungsionalitas gambar kustom: tampilan header, tampilan daftar, bilah alat, tipsalat, trackbar, dan tampilan pohon. Gambar kustom juga didukung untuk kontrol tombol jika Anda memiliki manifes aplikasi untuk memastikan bahwa Comctl32.dll versi 6 tersedia.

Jika pesan ini ditangani dalam prosedur dialog, Anda harus mengatur nilai yang dikembalikan sebagai bagian dari data jendela sebelum mengembalikan TRUE. Untuk informasi selengkapnya, lihat DialogProc.

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

Lihat juga

Konseptual
Gambar Kustom

Bagikan melalui