Share via

Using a Dialog Bar with a Rebar Control

 

The new home for Visual Studio documentation is Visual Studio 2017 Documentation on docs.microsoft.com.

The latest version of this topic can be found at Using a Dialog Bar with a Rebar Control.

As mentioned in Rebar Controls and Bands, each band can contain only one child window (or control). This might be a limitation if you want to have more than one child window per band. A convenient workaround is to create a dialog bar resource with multiple controls and then add a rebar band (containing the dialog bar) to the rebar control.

Normally, if you wanted the dialog bar band to appear transparent, you would set the WS_EX_TRANSPARENT extended style for the dialog bar object. However, because WS_EX_TRANSPARENT has some issues with properly painting the background of a dialog bar, you will need to do a little extra work to achieve the desired effect.

The following procedure details the steps necessary to achieve transparency without using the WS_EX_TRANSPARENT extended style.

To implement a transparent dialog bar in a rebar band

  1. Using the Add Class dialog box, add a new class (for example, CMyDlgBar) that implements your dialog bar object.

  2. Add a handler for the WM_ERASEBKGND message.

  3. In the new handler, modify the existing code to match the following example:

    BOOL CMyDlgBar::OnEraseBkgnd(CDC* pDC)
{
    CWnd* pParent = GetParent();
    ASSERT_VALID(pParent);
    CPoint pt(0, 0);
    MapWindowPoints(pParent, &pt, 1);
    pt = pDC->OffsetWindowOrg(pt.x, pt.y);
    LRESULT lResult = pParent->SendMessage(WM_ERASEBKGND,
        (WPARAM)pDC->m_hDC, 0L);
    pDC->SetWindowOrg(pt.x, pt.y);
    return (BOOL)lResult;
}

  4. Add a handler for the WM_MOVE message.

  5. In the new handler, modify the existing code to match the following example:

    void CMyDlgBar::OnMove(int x, int y)
{
   UNREFERENCED_PARAMETER(x);
   UNREFERENCED_PARAMETER(y);

   Invalidate();
}

The new handlers simulate the transparency of the dialog bar by forwarding the WM_ERASEBKGND message to the parent window and forcing a repaint every time the dialog bar object is moved.

See Also

Using CReBarCtrl
Controls