WM_CTLCOLORSTATIC

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

WM_CTLCOLORSTATIC hdcStatic = wParam (HDC);   / / לטפל להצגת ההקשר hwndStatic = lParam (HWND); / / לטפל לפקד סטטי 

 

פרמטרים

hdcStatic
הערך של wParam. לטפל להקשר התקן עבור חלון הפקד סטטי.
hwndStatic
הערך של lParam. לטפל לפקד סטטי.

להחזיר ערכים

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

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

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

הערות

פקדי עריכה אשר אינן לקריאה בלבד או לא זמין לא שלחת את ההודעה WM_CTLCOLORSTATIC; במקום זאת, הם לשלוח את ההודעה WM_CTLCOLOREDIT . עם זאת, למטרות תאימות, המערכת שולחת הודעה WM_CTLCOLOREDIT עבור פקדי עריכה לקריאה בלבד ולא זמין אם היישום תוכנן עבור Windows 3.1 או גירסה מוקדמת יותר.

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

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

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

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 2.0 or later.
  Header: Declared in winuser.h.

ראה גם

מבט כולל על פקדים סטטיים, הודעות דיווח סטטית של פקד, DefWindowProc, RealizePalette, SelectPalette, WM_CTLCOLORBTN, WM_CTLCOLORDLG, WM_CTLCOLOREDIT, WM_CTLCOLORLISTBOX, WM_CTLCOLORMSGBOX, WM_CTLCOLORSCROLLBAR

Index