Click here to Skip to main content
15,867,308 members
Articles / Desktop Programming / WTL
Article

CDialogRegionT - Skinning a WTL Dialog

Rate me:
Please Sign up or sign in to vote.
4.83/5 (20 votes)
29 Mar 2007CPOL2 min read 62.2K   2.3K   68   5
Simplest way to skin a WTL Dialog in 3 easy steps

CDialogRegionT - Sample Image

Introduction

Having a hard time putting a skin on a WTL Dialog, or want to create transparent dialogs? From here on you'll have to write three odd lines of code! You can create dialogs with the same shape of the supplied bitmap with a transparency feature.

Background

Earlier, if you wanted to skin a dialog you had to handle WM_ERASEBKGND message and then write the paint routine by yourself.

C++
BEGIN_MSG_MAP(CMainDlg)
    MESSAGE_HANDLER(WM_ERASEBKGND, OnEraseBkGnd)

CDialogRegionT template takes all of the burden from the programmer and does everything by itself. There are a couple of more messages which are taken care by this template class. These are WM_CTLCOLORSTATIC and WM_NCHITTEST. Handling WM_NCHITTEST message in our case allows us to drag the dialog by clicking anywhere on the dialog; this is done by returning HTCAPTION in this routine.

C++
LRESULT OnNCHitTest(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
    BOOL& bHandled)
{
    // We handle this message only if we have set the region
    bHandled = m_bIsRgnSet;

    if(m_bDlgMove)    // check if we can move the dialog
    {
        return HTCAPTION;
    }
    else
    {
        return 0;
    }
}

Using the code

I attempted to make the code usage as simple as possible. After including the DialogRegion.h in your WTL dialog class you just have to follow these three steps:

  1. Inherit the WTL dialog from CDialogRegionT template class.
    C++
    class CMainDlg : public CDialogImpl<CMainDlg>, public CUpdateUI<CMainDlg>,
        public CMessageFilter, public CIdleHandler, CDialogRegionT<CMainDlg>
    {
  2. In the message map add CHAIN_MSG_MAP entry to chain messages to this class
  3. C++
    BEGIN_MSG_MAP(CMainDlg)
        MESSAGE_HANDLER(WM_INITDIALOG, OnInitDialog)
        COMMAND_ID_HANDLER(ID_APP_ABOUT, OnAppAbout)
        COMMAND_ID_HANDLER(IDOK, OnOK)
        COMMAND_ID_HANDLER(IDCANCEL, OnCancel)
        CHAIN_MSG_MAP(CDialogRegionT<CMainDlg>)
    END_MSG_MAP()
    
  4. Use SetBkBitmap method in the WM_INITDIALOG routine to specify the skin file. SetBkBitmap is an overloaded function and takes the color which is to be set as transparent (RGB(255,0,255) is default transparent color)

    • If you are providing a resource bitmap:
      C++
      SetBKBitmap(IDB_BITMAP1);
      Here IDB_BITMAP1 is the bitmap resource identifier.

    • In case you are providing a bitmap file:
      C++
      SetBKBitmap("MyBitmap.bmp");
      Here MyBitmap.bmp is the name of bitmap file in the directory of the target executable generated.

Things to note

In the background section I did not discuss the WM_CTLCOLORSTATIC message. The CDialogRegionT template class uses this message to return the color for the static controls. In our case we will be using any color bitmap so the static controls needs to be drawn as transparent. So when the static controls are to be colored we set the background color as transparent and return hollow brush.

C++
LRESULT OnCtlColorStatic(UINT /*uMsg*/, WPARAM wParam, LPARAM lParam, 
    BOOL& bHandled)
{
    // We handle this message only if we have set the region
    bHandled = m_bIsRgnSet;

    if(m_bIsRgnSet)
    {
        ::SetBkMode((HDC)wParam, TRANSPARENT);
        return (LRESULT) GetStockObject (HOLLOW_BRUSH);
    }
    return 0;
}

I came across one problem: if I add the manifest for common controls 6, the static controls are drawn black. So you have to ensure that you are not using the common controls 6 in your project. You can choose not to add common controls manifest when you are creating the project using the WTL project wizard. If you already have a WTL project and upon adding CDialogRegionT class make the static controls to be drawn black, you can remove the common controls manifest from the .rc file.

License

This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


Written By
Software Developer (Senior)
India India
This member has not yet provided a Biography. Assume it's interesting and varied, and probably something to do with programming.

Comments and Discussions

 
GeneralBug Report Pin
hawkgao01292-Jun-09 5:22
hawkgao01292-Jun-09 5:22 
GeneralRe: Bug Report Pin
kokobango26-Apr-18 5:03
kokobango26-Apr-18 5:03 
GeneralGreat Pin
Sachin Gorade30-Apr-08 19:34
Sachin Gorade30-Apr-08 19:34 
Nice article.

Sky is the limit...

GeneralRe: Great Pin
joyjjjz22-Sep-08 21:14
joyjjjz22-Sep-08 21:14 
GeneralSupporting visual styles Pin
Jim Barry11-Sep-06 14:34
Jim Barry11-Sep-06 14:34 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.