WM_CTLCOLORDLG

WM_CTLCOLORDLG נשלחת הודעת תיבת דו-שיח לפני המערכת מצייר את תיבת הדו-שיח. על-ידי תגובה להודעה זו, תיבת הדו-שיח להגדיר צבעי הטקסט והרקע שלו באמצעות המזהה הייחודי של הקשר ההתקן של התצוגה נתון.

WM_CTLCOLORDLG hdcDlg = wParam (HDC);   / / לטפל של hwndDlg הקשר התצוגה של תיבת הדו-שיח = lParam (HWND); / / לטפל בתיבת הדו-שיח 

 

פרמטרים

hdcDlg
הערך של wParam. מזהה הקשר ההתקן עבור תיבת הדו-שיח.
hwndDlg
הערך של lParam. מזהה את תיבת הדו-שיח.

להחזיר ערכים

אם יישום מעבד הודעה זו, עליה להחזיר את נקודת האחיזה של מברשת. המערכת משתמשת במברשת כדי לצבוע את הרקע של תיבת הדו-שיח.

פעולת ברירת מחדל

הפונקציה DefWindowProc בוחר את צבעי ברירת המחדל של המערכת עבור תיבת הדו-שיח.

הערות

המערכת לא להרוס באופן אוטומטי את המברשת המוחזר. זוהי האחריות של היישום כדי להרוס את המברשת כאשר אין עוד צורך.

מעולם לא לשלוח את ההודעה WM_CTLCOLORDLG בין הליכי משנה. הוא נשלח רק בתוך הליך משנה אחד.

שים לב כי ההודעה WM_CTLCOLORDLG נשלחת אל תיבת הדו-שיח עצמו; כל האחרים WM_CTLCOLOR * ההודעות נשלחות אל הבעלים של הפקד.

אם הליך תיבת הדו-שיח מטפל הודעה זו, אותה עליו לבצע המרה של הערך המוחזר המבוקש כדי BOOL, להחזיר את הערך ישירות. אם הפרוצדורה תיבת הדו-שיח מחזירה FALSE, מתבצע טיפול בהודעות ברירת המחדל. אין התייחסות הערך DWL_MSGRESULT המוגדר על-ידי הפונקציה SetWindowLong.

QuickInfo

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

Index