HOWTO: Handle OCM_CTLCOLORxxx Reflected Messages

ID: Q148242

The information in this article applies to:

The Microsoft Foundation Classes (MFC), included with:
- Microsoft Visual C++, 32-bit Editions, versions 4.0, 4.1, 4.2, 5.0, 6.0

SUMMARY

This article shows you how to change the background color of an OLE control that subclasses a Windows Control, with sample code for an Edit control.

This article should apply to Button, Static, ListBox, and ComboBox controls as well.

MORE INFORMATION

Please refer to the following article in the Microsoft Knowledge Base:

Q130952 WM_CTLCOLORxxx Message Changes for Windows 95

for more about the exact WM_CTLCOLORxxx message sent by each control. If a control sends the WM_CTLCOLORSTATIC, you have to handle the OCM_CTLCOLORSTATIC message in the OCX and so on.

To change the background color of an OLE Control that subclasses an Edit Control, you must handle the OCM_CTLCOLOREDIT(32-bit) messages. These messages are intercepted by the "reflector window" (created for an OLE control that subclasses a Windows control) that reflects them back to the OLE control itself. In response to these reflected messages, you must set the background color (and optionally the foreground color) and return a handle to a brush initialized with the background color.

Step-by-Step Example

The sample code in this example illustrates how to handle OCM_CTLCOLOREDIT in order to change the background color of an OLE control that subclasses an Edit control

Generate an MFC ActiveX Control Wizard Application, and select the option that allows you to subclass an Edit control.

To handle an OCM_CTLCOLOREDIT reflected window message, declare the following handler function in the .h file of your control's class:
```
      LRESULT OnOcmCtlColor(WPARAM wParam, LPARAM lParam); 
```

In the .cpp file of your control's class, add an ON_MESSAGE entry to the message map:
```
      ON_MESSAGE(OCM_CTLCOLOREDIT, OnOcmCtlColor) 
```

Also in the .cpp file, implement the OnOcmCtlColor member function to process the reflected message:


      // Assuming CEdtclrCtrl is the class for this control
      LRESULT CEdtclrCtrl::OnOcmCtlColor(WPARAM wParam, LPARAM lParam)
      {
        //Declare CBrush* m_pBackBrush in your control's .h file
        if (m_pBackBrush == NULL)
           m_pBackBrush = new CBrush(RGB(0,0,0));
        CDC* pdc = CDC::FromHandle((HDC)wParam);
        pdc->SetBkMode(TRANSPARENT);
        pdc->SetBkColor(RGB(0,0,0));
        pdc->SetTextColor(RGB(0,255,0));
        HBRUSH far* hbr = (HBRUSH far*)m_pBackBrush->GetSafeHandle();
        return ((DWORD)hbr);
      }

NOTE: In your control's constructor, set m_pBackBrush = NULL, and in your control's destructor, delete m_pBackbBrush.

Build and register your control.

Insert this control into the ActiveX Control Test Container. Notice that the background color of your OLE control is changed.

REFERENCES

Refer to technical article [ASCII 147]TN062: Message Reflection for Windows Controls[ASCII 148] and the article [ASCII 147]ActiveX Controls: Sub-classing a Windows Control in Visual C++ Programmer's Guide.[ASCII 148]

Additional query words: list box combo

Keywords : kbcode kbole kbMFC kbVC400 kbVC410 kbVC500 kbVC600
Version : 4.0 4.1 4.2 5.0
Platform : NT WINDOWS
Issue type : kbhowto