How to change the color scheme of a standard child class of controls in MFC (132080)



The information in this article applies to:

  • The Microsoft Foundation Classes (MFC), when used with:
    • Microsoft Visual C++ for Windows, 16-bit edition 1.0
    • Microsoft Visual C++ for Windows, 16-bit edition 1.5
    • Microsoft Visual C++ for Windows, 16-bit edition 1.51
    • Microsoft Visual C++ for Windows, 16-bit edition 1.52
    • Microsoft Visual C++, 32-bit Editions 1.0
    • Microsoft Visual C++, 32-bit Editions 2.0
    • Microsoft Visual C++, 32-bit Editions 2.1
    • Microsoft Visual C++, 32-bit Editions 2.2
    • Microsoft Visual C++, 32-bit Editions 4.0
    • Microsoft Visual C++, 32-bit Enterprise Edition 5.0
    • Microsoft Visual C++, 32-bit Enterprise Edition 6.0
    • Microsoft Visual C++, 32-bit Professional Edition 5.0
    • Microsoft Visual C++, 32-bit Professional Edition 6.0
    • Microsoft Visual C++, 32-bit Learning Edition 6.0
    • Microsoft Visual C++ .NET (2002)
  • Microsoft Windows XP Home Edition
  • Microsoft Windows XP Professional
  • Microsoft Visual C++ .NET (2003)

This article was previously published under Q132080
Note Microsoft Visual C++ .NET (2002) supports both the managed code model that is provided by the Microsoft .NET Framework and the unmanaged native Microsoft Windows code model. The information in this article applies only to unmanaged Visual C++ code.

SUMMARY

To change the color scheme of a standard class of controls in an MFC-based application, follow these steps:
  1. Derive a class from the standard control class, such as CEdit.
  2. Define a static member variable of class CBrush to be the brush for that class of controls.
  3. Override the control's member function OnChildNotify(), handle the message WM_CTLCOLOR, and use the new brush. In MFC 4.0, this could also be done by using an ON_WM_CTLCOLOR_REFLECT handler.
NOTE: In 32-bit Windows, the controls do not send the WM_CTLCOLOR message. They send WM_CTLCOLORxxx messages, where xxx is the type of control. For example, static control sends the WM_CTLCOLORSTATIC message.

MORE INFORMATION

This approach works for list boxes, the list boxes of combo boxes, button controls, edit controls, static controls, message boxes, and dialog boxes. (This approach does not work for push buttons and the CRichEditCtrl. The color of a standard CButton object is determined by system settings. If you want a different color for push buttons, use a CBitmapButton. To change the color of a CRichEditCtrl use its member functions.)

For an alternative approach, view the following article in the Microsoft Knowledge Base:

117778 How to change the background color of an MFC Edit Control

It illustrates how to change the background color of a control in the parent window.

When a control is about to be redrawn, it sends the message WM_CTLCOLOR to its parent. This message is handled by the OnCtlColor() member function of the parent.

OnCtlColor() allows the parent to modify the drawing of the child by:

  • Specifying the background brush.
  • Changing the text color.
  • Making other changes to the device context with which the drawing is to be done.
One of the first things the default implementation of OnCtlColor() does is to call the OnChildNotify() member function of the child that sent the message. By overriding this OnChildNotify() member function, the child can determine its own color scheme, instead of taking it from the parent.

The following sample code defines a class of edit controls with red text on a green background. The sample code shows only what is necessary to change the color of the controls. It does not include code generated by the ClassWizard.

Sample Code

   /* Compile options needed:  Default
   */ 

   // NOTE:  The sample code is for 32-bit. It has to be modified for
   // 16-bit. See the comment below.

   // ** MYEDIT.H **

   class CMyEdit : public CEdit
   {
   public:
      BOOL OnChildNotify(UINT message, WPARAM wParam, LPARAM Param,
          LRESULT* pLResult);
   protected:
      static CBrush m_brush;
   };

   // ** MYEDIT.CPP **

   #include "myedit.h"

   // Create a green brush for the background for the class of controls:
   CBrush CMyEdit::m_brush(RGB(0,128,0));

   BOOL CMyEdit::OnChildNotify(UINT message, WPARAM wParam,
                               LPARAM lParam, LRESULT* pLResult)
   {
   // If "message" is not the message you're after, do default processing:

   // For 16-bit applications change WM_CTLCOLOREDIT to WM_CTLCOLOR
      if (message != WM_CTLCOLOREDIT)
      {
         return CEdit::OnChildNotify(message,wParam,lParam,pLResult);
      }

   // Set the text foreground to red:
      HDC hdcChild = (HDC)wParam;
      SetTextColor(hdcChild, RGB(0,0,255));

   // Set the text background to green:
      SetBkColor(hdcChild, RGB(0,128,0));

   // Send what would have been the return value of OnCtlColor() - the
   // brush handle - back in pLResult:
      *pLResult = (LRESULT)(m_brush.GetSafeHandle());

   // Return TRUE to indicate that the message was handled:
      return TRUE;
   }
				

Modification Type:MajorLast Reviewed:4/28/2005
Keywords:kbCtrl kbGDI kbhowto KbUIDesign KB132080 kbAudDeveloper