Bagikan melalui

WM_CTLCOLORDLG pesan

  • Artikel

Dikirim ke kotak dialog sebelum sistem menggambar kotak dialog. Dengan merespons pesan ini, kotak dialog dapat mengatur teks dan warna latar belakangnya menggunakan handel konteks perangkat tampilan yang ditentukan.

#define WM_CTLCOLORDLG                  0x0136

Parameter

wParam

Handel ke konteks perangkat untuk kotak dialog.

lParam

Handel ke kotak dialog.

Menampilkan nilai

Jika aplikasi memproses pesan ini, aplikasi harus mengembalikan handel ke kuas. Sistem menggunakan kuas untuk mengecat latar belakang kotak dialog.

Keterangan

Secara default, fungsi DefWindowProc memilih warna sistem default untuk kotak dialog.

Sistem tidak secara otomatis menghancurkan kuas yang dikembalikan. Ini adalah tanggung jawab aplikasi untuk menghancurkan kuas ketika tidak lagi diperlukan.

Pesan WM_CTLCOLORDLG tidak pernah dikirim di antara utas. Ini hanya dikirim dalam satu utas.

Perhatikan bahwa pesan WM_CTLCOLORDLG dikirim ke kotak dialog itu sendiri; semua pesan WM_CTLCOLOR* lainnya dikirim ke pemilik kontrol.

Jika prosedur kotak dialog menangani pesan ini, itu harus mentransmisikan nilai pengembalian yang diinginkan ke INT_PTR dan mengembalikan nilai secara langsung. Jika prosedur kotak dialog mengembalikan FALSE, maka penanganan pesan default dilakukan. Nilai DWL_MSGRESULT yang ditetapkan oleh fungsi SetWindowLong diabaikan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
 Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung
 Windows 2000 Server [hanya aplikasi desktop]
Header
Winuser.h (termasuk Windows.h)

Lihat juga

Referensi

DefWindowProc

SetWindowLong

Konseptual

Kotak Dialog

Sumber Daya Lainnya

RealisasiPalette

SelectPalette