WM_CTLCOLORDLG pesan
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 |
|
Lihat juga
-
Referensi
-
Konseptual
-
Sumber Daya Lainnya