WM_CTLCOLORDLG נשלחת הודעת תיבת דו-שיח לפני המערכת מצייר את תיבת הדו-שיח. על-ידי תגובה להודעה זו, תיבת הדו-שיח להגדיר צבעי הטקסט והרקע שלו באמצעות המזהה הייחודי של הקשר ההתקן של התצוגה נתון.
WM_CTLCOLORDLG hdcDlg = wParam (HDC); / / לטפל של hwndDlg הקשר התצוגה של תיבת הדו-שיח = lParam (HWND); / / לטפל בתיבת הדו-שיח
אם יישום מעבד הודעה זו, עליה להחזיר את נקודת האחיזה של מברשת. המערכת משתמשת במברשת כדי לצבוע את הרקע של תיבת הדו-שיח.
הפונקציה DefWindowProc בוחר את צבעי ברירת המחדל של המערכת עבור תיבת הדו-שיח.
המערכת לא להרוס באופן אוטומטי את המברשת המוחזר. זוהי האחריות של היישום כדי להרוס את המברשת כאשר אין עוד צורך.
מעולם לא לשלוח את ההודעה WM_CTLCOLORDLG בין הליכי משנה. הוא נשלח רק בתוך הליך משנה אחד.
שים לב כי ההודעה WM_CTLCOLORDLG נשלחת אל תיבת הדו-שיח עצמו; כל האחרים WM_CTLCOLOR * ההודעות נשלחות אל הבעלים של הפקד.
אם הליך תיבת הדו-שיח מטפל הודעה זו, אותה עליו לבצע המרה של הערך המוחזר המבוקש כדי BOOL, להחזיר את הערך ישירות. אם הפרוצדורה תיבת הדו-שיח מחזירה FALSE, מתבצע טיפול בהודעות ברירת המחדל. אין התייחסות הערך DWL_MSGRESULT המוגדר על-ידי הפונקציה SetWindowLong.
nbsp; Windows &NT: מחייב גירסה 3.1 או גירסה מתקדמת יותר.
Windows:נדרש Windows 95 או גירסה מתקדמת יותר.
חלונות CE:דורש גירסה 1.0 ואילך.
כותרת עליונה:להצהיר על winuser.h.
מבט כולל על תיבות דו-שיח, הודעות בתיבת דו-שיח, DefWindowProc, RealizePalette, SelectPalette, WM_CTLCOLORBTN, WM_CTLCOLOREDIT, WM_CTLCOLORLISTBOX, WM_CTLCOLORMSGBOX, WM_CTLCOLORSCROLLBAR, WM_CTLCOLORSTATIC