WTL入门（2）-- WTL基础

薛枫

2023-12-01

源代码下载： http://download.csdn.net/source/3522792

WTL Overview

WTL的类可以分为以下几类：

1）窗口实现类 - CFrameWindowImpl, CMDIFrameWindowImpl …
2）控件封装类 - CButton, CListViewCtrl …
3）GDI封装类 - CDC, CMenu …
4）特殊的UI特性 - CSplitterWindow, CUpdateUI, CDialogResize, CCustomDraw …
5）基础类和宏 - CString, CRect, BEGIN_MSG_MAP_EX …

Beginning a WTL EXE

我们从零开始不通过WTL AppWizard创建一个WTL项目。

1）在Stdafx.h添加头文件和定义宏

// stdafx.h

#define STRICT

#define WIN32_LEAN_AND_MEAN

#define _WTL_USE_CSTRING   // 如果计划使用WTL封装的CString类，需要定义此宏。

// CString是在atlmisc.h中定义的，但是在其他的头文件中可能会用到此类，尤其在atlmisc.h之前被包含的头文件如AtlApp.h

// 因此，通过这种方法可以预声明一个CString类，以告诉其他头文件CString是个什么东东

 

#include <atlbase.h>       // base ATL classes

#include <atlapp.h>        // base WTL classes，包含消息处理和CAppModule的定义（派生于CComModule类）

extern CAppModule _Module; // WTL version of CComModule，它包含我们所需要的空闲进程和UI更新等特性

#include <atlwin.h>        // ATL GUI classes

#include <atlframe.h>      // WTL frame window classes

#include <atlmisc.h>       // WTL utility classes like CString

#include <atlcrack.h>      // WTL enhanced msg map macros

2）定义一个Frame Window，其派生于CFrameWindowImpl。并且用DECLARE_FRAME_WND_CLASS宏定义窗口类。

// MyWindow.h:

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

     // 两个参数，前者表示窗口名字，如果为NULL，WTL将自动生成一个

     // 后者表示窗口的资源ID。

// WTL将会根据此ID搜索图标、菜单、快捷键表等资源，并在窗口创建时加载它们。

// 同样也通过此ID搜索一个字符串用于窗口的Title

     DECLARE_FRAME_WND_CLASS(_T("First WTL window"), IDR_MAINFRAME);

 

     BEGIN_MSG_MAP(CMyWindow)

         // 用这种方法将消息链到其基类中（值得注意的是WM_SIZE和WM_DESTORY）

CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

     END_MSG_MAP()

}

3）WinMain函数，与上一节相似：

#include "stdafx.h"

#include "MyWindow.h"

 

CAppModule _Module;

 

int APIENTRY WinMain ( HINSTANCE hInstance, HINSTANCE hPrevInstance,

                         LPSTR lpCmdLine, int nCmdShow )

{

     _Module.Init ( NULL, hInstance );

 

     CMyWindow wndMain;

     MSG msg;

 

     // Create the main window

     if ( NULL == wndMain.CreateEx() )

         return 1;       // Window creation failed

 

     // Show the window

     wndMain.ShowWindow ( nCmdShow );

     wndMain.UpdateWindow();

 

     // Standard Win32 message loop

     while ( GetMessage ( &msg, NULL, 0, 0 ) > 0 )

     {

         TranslateMessage ( &msg );

         DispatchMessage ( &msg );

     }

 

     _Module.Term();

     return msg.wParam;

}

此时运行程序，将会起动一个空窗口的。

WTL Message Map Enhancements

ATL中需要对消息参数WPARAM和LPARAM进行解包的，但是WTL中增强的消息路由机制已经帮我们解决了此问题，
对于ATL3.0，必须用宏BEGIN_MSG_MAP_EX定义消息路由
对于ATL7.0/7.1,从CwindowImpl和CDialogImpl派生的类可以直接使用宏BEGIN_MSG_MAP定义消息路由，其他类必须使用宏BEGIN_MSG_MAP_EX定义消息路由。

4）添加WM_CREATE消息处理

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

BEGIN_MSG_MAP_EX(CMyWindow)

    // 用这种方法声明WM_CREATE消息的处理

        MSG_WM_CREATE(OnCreate)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

    END_MSG_MAP()

 

    // OnCreate(...) ?

};

         MSG_WM_CREATE宏的定义如下：

#define MSG_WM_CREATE(func) \

    if (uMsg == WM_CREATE) \

    { \

        SetMsgHandled(TRUE); \

        lResult = (LRESULT)func((LPCREATESTRUCT)lParam); \

        if(IsMsgHandled()) \

            return TRUE; \

}

可以看出，消息参数被解包为LPCREATESTRUCT，只有一个参数，返回值为LRESULT对象。同时没有了bHandle参数，通过SetMsgHandled()代替此参数。

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

    BEGIN_MSG_MAP_EX(CMyWindow)

        MSG_WM_CREATE(OnCreate)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

    END_MSG_MAP()

 

    LRESULT OnCreate(LPCREATESTRUCT lpcs)

    {

        SetTimer ( 1, 1000 );

        SetMsgHandled(false);

        return 0;

    }

};

CFrameWindowImpl派生于CWindow，故其有SetTimer()函数。设置每1s触发一个计时消息的计时器。同时用SetMsgHandled(false);设置其基类也能处理该消息。这是一个好的习惯。

5）添加WM_DESTORY处理，销毁计时器
MSG_WM_DESTORY宏的定义如下：

#define MSG_WM_DESTROY(func) \

    if (uMsg == WM_DESTROY) \

    { \

        SetMsgHandled(TRUE); \

        func(); \

        lResult = 0; \

        if(IsMsgHandled()) \

            return TRUE; \

}

其定义如下：

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

    BEGIN_MSG_MAP_EX(CMyWindow)

        MSG_WM_CREATE(OnCreate)

        MSG_WM_DESTROY(OnDestroy)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

    END_MSG_MAP()

 

    void OnDestroy()

    {

        KillTimer(1);

        SetMsgHandled(false);

    }

};

6）添加WM_TIMER处理，每秒刷新一次窗口

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

    BEGIN_MSG_MAP_EX(CMyWindow)

        MSG_WM_CREATE(OnCreate)

        MSG_WM_DESTROY(OnDestroy)

        MSG_WM_TIMER(OnTimer)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

    END_MSG_MAP()

 

    void OnTimer ( UINT uTimerID, TIMERPROC pTimerProc )

    {

        if ( 1 != uTimerID )

            SetMsgHandled(false);

        else

            RedrawWindow();

    }

};

7）添加WM_ERASEBKGND消息处理，用于刷新背景色，绘制当前时间

class CMyWindow : public CFrameWindowImpl<CMyWindow>

{

public:

    BEGIN_MSG_MAP_EX(CMyWindow)

        MSG_WM_CREATE(OnCreate)

        MSG_WM_DESTROY(OnDestroy)

        MSG_WM_TIMER(OnTimer)

        MSG_WM_ERASEBKGND(OnEraseBkgnd)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMyWindow>)

    END_MSG_MAP()

 

    LRESULT OnEraseBkgnd ( HDC hdc )

    {

       CDCHandle  dc(hdc);

       CRect      rc;

       SYSTEMTIME st;

       CString    sTime;

 

        // Get our window's client area.

        GetClientRect ( rc );

 

        // Build the string to show in the window.

        GetLocalTime ( &st );

        sTime.Format ( _T("The time is %d:%02d:%02d"), 

                       st.wHour, st.wMinute, st.wSecond );

 

        // Set up the DC and draw the text.

        dc.SaveDC();

 

        dc.SetBkColor ( RGB(255,153,0) );

        dc.SetTextColor ( RGB(0,0,0) );

        dc.ExtTextOut ( 0, 0, ETO_OPAQUE, rc, sTime, 

                        sTime.GetLength(), NULL );

 

        // Restore the DC.

        dc.RestoreDC(-1);

        return 1;    // We erased the background (ExtTextOut did it)

    }

};

Generate Codes by AppWizard（VC8）

1）   自动生成了三个类：CMainFrame，CAboutDlg，CxxxView。
2）   自动生成了程序入口函数_tWinMain()，用于初始化COM、普通控件以及_module，然后调用一个全局的Run()。Run()里创建消息循环类CMessageLoop，并且创建窗口。
3）   CMainFrame类：

class CMainFrame : public CFrameWindowImpl<CMainFrame>,

                   public CUpdateUI<CMainFrame>,

                   public CMessageFilter,

                   public CIdleHandler

{

public:

    DECLARE_FRAME_WND_CLASS(NULL, IDR_MAINFRAME)

 

    BEGIN_UPDATE_UI_MAP(CMainFrame)

    END_UPDATE_UI_MAP()

 

    BEGIN_MSG_MAP(CMainFrame)

        // ...

        CHAIN_MSG_MAP(CUpdateUI<CMainFrame>)

        CHAIN_MSG_MAP(CFrameWindowImpl<CMainFrame>)

    END_MSG_MAP()

 

    BOOL PreTranslateMessage(MSG* pMsg);

    BOOL OnIdle();

 

protected:

    CWTLClockView m_view;

};

CMessageFilter是一个提供PreTranslateMessage()的混合类，CIdleHandler是一个提供OnIdle()的混合类。CMessageLoop, CIdleHandler, 和 CUpdateUI一起提供UI的更新（类似于MFC中ON_UPDATE_COMMAND_UI）。
CMainFrame::OnCreate()创建view窗口，并保存其句柄，以使主窗口大小变化时view窗口能随之变化。同时把CMainFrame对象添加到_module的消息过滤器和idle handler中。

LRESULT CMainFrame::OnCreate(UINT /*uMsg*/, WPARAM /*wParam*/, 

                             LPARAM /*lParam*/, BOOL& /*bHandled*/)

{

    m_hWndClient = m_view.Create(m_hWnd, rcDefault, NULL, |

                                 WS_CHILD | WS_VISIBLE | WS_CLIPSIBLINGS |

                                   WS_CLIPCHILDREN, WS_EX_CLIENTEDGE);

 

    // register object for message filtering and idle updates

    CMessageLoop* pLoop = _Module.GetMessageLoop();

    pLoop->AddMessageFilter(this);

    pLoop->AddIdleHandler(this);

 

    return 0;

}

CMessageLoop Internals

CMessageLoop提供程序的消息泵。不仅提供TranslateMessage/DispatchMessage，还提供消息过滤PreTranslateMessage()和空闲处理OnIdle()。下面是CMessageLoop::Run()的伪代码：

int Run()

{

MSG msg;

 

    for(;;)

        {

        while ( !PeekMessage(&msg) )

            CallIdleHandlers();

 

        if ( 0 == GetMessage(&msg) )

            break;    // WM_QUIT retrieved from the queue

 

        if ( !CallPreTranslateMessageFilters(&msg) )

            {

            // if we get here, message was not filtered out

            TranslateMessage(&msg);

            DispatchMessage(&msg);

            }

        }

 

    return msg.wParam;

}

通过在窗口对象创建时调用CMessageLoop::AddMessageFilter()和CMessageLoop::AddIdleHandler()，就可以实现消息泵了。
本消息池中不处理TranslateAccelerator() 和 IsDialogMessage()。它们在CFrameWindowImpl中处理。如果要在程序中添加非模式对话框，需要在CMainFrame:: PreTranslateMessage()中调用IsDialogMessage()。

CFrameWindowImpl Internals

CFrameWindowImpl和其基类CFrameWindowImplBase提供了大量的特性，如工具条、状态条、tooltips，toolButton等。
1）WM_SIZE消息。CFrameWindowImplBase的成员m_hWndClient存储Frame的view视图句柄。因此：

LRESULT OnSize(UINT /*uMsg*/, WPARAM wParam, LPARAM /*lParam*/, BOOL& bHandled)

{

    // 检查是否最小化，如果不是，调用UpdateLayout()

    if(wParam != SIZE_MINIMIZED)

    {

        T* pT = static_cast<T*>(this);

        pT->UpdateLayout();

    }

 

    bHandled = FALSE;

    return 1;

}

void UpdateLayout(BOOL bResizeBars = TRUE)

{

RECT rect;

    GetClientRect(&rect);

 

    // position bars and offset their dimensions

    UpdateBarsPosition(rect, bResizeBars);

 

    // resize client window

    if(m_hWndClient != NULL)

        ::SetWindowPos(m_hWndClient, NULL, rect.left, rect.top,

            rect.right - rect.left, rect.bottom - rect.top,

            SWP_NOZORDER | SWP_NOACTIVATE);

}

Back to the Clock Program

class CWTLClockView : public CWindowImpl<CWTLClockView>

{

public:

    DECLARE_WND_CLASS(NULL)

 

    BOOL PreTranslateMessage(MSG* pMsg);

 

    BEGIN_MSG_MAP_EX(CWTLClockView)

        MESSAGE_HANDLER(WM_PAINT, OnPaint)

        MSG_WM_CREATE(OnCreate)

        MSG_WM_DESTROY(OnDestroy)

        MSG_WM_TIMER(OnTimer)

        MSG_WM_ERASEBKGND(OnEraseBkgnd)

    END_MSG_MAP()

};

UI Updating

处理UI的更新需要三个类的结合:CMessageLoop,CIdleHandler,CUpdateUI。CUpdateUIBase中存储5个常量对应于5中控件的更新。

menu bar items: UPDUI_MENUBAR
popup menu items: UPDUI_MENUPOPUP
toolbar buttons: UPDUI_TOOLBAR
status bar panes: UPDUI_STATUSBAR
child windows: UPDUI_CHILDWINDOW

CUpdateUI可以设置控件的enabled state, checked state, and text of items等。
关于UI更新，我们有四件事情要做：
1）   从CUpdateUI和CIdleHandler派生Frame窗口类
2）   从CFrameWindow链接消息到CUpdateUI
3）   添加Frame窗口类到_module的Idle handles的列表中
4）   填充Frame窗口下的UPDATE_UI_MAP宏

New menu items to control the clock

添加两个菜单项 ID_CLOCK_START, ID_CLOCK_STOP，用来控制时钟。

class CMainFrame : public ...

{

public:

    // ...

    BEGIN_UPDATE_UI_MAP(CMainFrame)

        UPDATE_ELEMENT(ID_CLOCK_START, UPDUI_MENUPOPUP)

        UPDATE_ELEMENT(ID_CLOCK_STOP, UPDUI_MENUPOPUP)

    END_UPDATE_UI_MAP()

    // ...

};

Calling UIEnable()

通过上面的方法，来控制UI的可操作性。

LRESULT CMainFrame::OnCreate(UINT /*uMsg*/, WPARAM /*wParam*/, 

                             LPARAM /*lParam*/, BOOL& /*bHandled*/)

{

    m_hWndClient = m_view.Create(...);

 

    // register object for message filtering and idle updates

    // [omitted for clarity]

 

    // Set the initial state of the Clock menu items:

    UIEnable (ID_CLOCK_START, false );

    UIEnable (ID_CLOCK_STOP, true );

 

    return 0;

}

参考原文

http://download.csdn.net/source/3479570

WTL入门（2）-- WTL基础

WTL Overview

Beginning a WTL EXE

WTL Message Map Enhancements

Generate Codes by AppWizard（VC8）

CMessageLoop Internals

CFrameWindowImpl Internals

New menu items to control the clock

Calling UIEnable()

相关阅读

相关文章

相关问答

相关文档