HOWTO: Change the Color of an MFC Child Control Class

Last reviewed: June 26, 1997
Article ID: Q132080
The information in this article applies to:
  • The Microsoft Foundation Classes (MFC) included with: - Microsoft Visual C++ for Windows, versions 1.0, 1.5, 1.51, 1.52 - Microsoft Visual C++, 32-bit Edition, versions 1.0, 2.0, 2.1,

         2.2, 4.0, 5.0
    

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, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q117778
   TITLE     : Changing 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;
   }


Additional reference words: 2.50 2.51 2.52 3.00 3.10 3.20
Keywords : kbcode kbprg MfcUI
Technology : kbMfc
Version : 1.0 1.5 1.51 1.52 1.0 2.0 2.1
Platform : NT WINDOWS
Issue type : kbhowto


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: June 26, 1997
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.