当前位置: 首页 > 工具软件 > WTL > 使用案例 >

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

 类似资料: