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