ATL&WTL第二部分

第二部分 - WTL 中的 GUI 基础类

内容

? ? ? ? ?

第二部分介绍 WTL 综述

开始一个 WTL EXE WTL 消息映射的增强

使用 WTL AppWizard 可以得到什么

? ? ?

通历向导(VC 6) 通历向导(VC 7) 检查生成的代码

? ? ? ?

CMessageLoop 内幕 CFrameWindowImpl 内幕 回到时钟程序 UI 更新

? ?

控制时钟的新菜单项 调用 UIEnable() ? ? ?

关于消息映射的最后注意事项 下一站,1995 修订历史

第二部分介绍

好,是实实在在地讲述 WTL 的时候了!在这部分里,我会介绍写一个主框架窗口的基础知识,以及 WTL 引入的比较受欢迎的改进,比如 UI 更新和更好的消息影射。为了最大程度地掌握本部分的内容,你应该安装 WTL 以使其头文件处于 VC 的搜索路径中,而且 AppWizard 也在适当的目录下。WTL 的分发包中附有如何安装 AppWizard 的说明,请参考该文档。

记住,如果你安装 WTL 或者编译示例代码时遇到了任何问题,请在张贴你的问题之前阅读第一部分的 ReadMe 一节。

WTL 综述

WTL 的类可以分为几个主要的类别:

1. 框架窗口的实现 - CFrameWindowImpl, CMDIFrameWindowImpl 2. 控件封装 - CButton, CListViewCtrl 3. GDI 封装 - CDC, CMenu 4. 特殊的 UI 特性

- CSplitterWindow, CUpdateUI, CDialogResize, CCustomDraw 5. 工具类以及宏 - CString, CRect, BEGIN_MSG_MAP_EX

本文将深入到框架窗口中去,顺便提及一些 UI 特性和工具类。大多数的类都是独立的,不过也有一些像 CDialogResize 这样的嵌入类(mix-in)。

开始一个 WTL EXE

如果你不使用 WTL AppWizard (稍后我们就会提到它),那么一个 WTL EXE 一开始会很像一个 ATL EXE。如同第一部分中的那样,本文中的示例代码是另一个框架窗口,不过为了展示一些 WTL 的特性,较之前者不再那么微不足道。 在本节里,我们会从头开始一个新的 EXE。主窗口会在其客户区显示当前的时间。下面是一个基本的 stdafx.h:

#define STRICT

#define WIN32_LEAN_AND_MEAN #define _WTL_USE_CSTRING

#include // base ATL classes #include // base WTL classes

extern CAppModule _Module; // WTL version of CComModule #include // ATL GUI classes

#include // WTL frame window classes #include // WTL utility classes like CString #include // WTL enhanced msg map macros atlapp.h 是要包含的第一个 WTL 头文件。它包含了用于消息处理的类和一个继承自 CComModule 的类 CAppModule。如果你计划使用 CString那就还应该定义 _WTL_USE_CSTRING,因为 CString 定义在 atlmisc.h 里,而在 atlmisc.h 包含的其他头文件里有的特性会使用到 CString。定义 _WTL_USE_CSTRING 使得 atlapp.h 会前向声明 CString 类,从而使其他的这些头文件知道一个 CString 究竟是什么。

(注意,我们需要一个全局的 CAppModule 变量尽管在第一部分里这不是必需的。CAppModule 的一些特性与我们所需的空闲处理以及 UI 更新相关,所以我们需要 CAppModule 的存在)

接下来我们来定义我们的框架窗口。像我们这样的 SDI 窗口继承

自 CFrameWindowImpl。窗口类名是使用 DECLARE_FRAME_WND_CLASS 而不是DECLARE_WND_CLASS 来定义。这儿是 MyWindow.h 里我们窗口定义的开头: // MyWindow.h:

class CMyWindow : public CFrameWindowImpl {

public:

DECLARE_FRAME_WND_CLASS(_T(\),

IDR_MAINFRAME);

BEGIN_MSG_MAP(CMyWindow)

CHAIN_MSG_MAP(CFrameWindowImpl) END_MSG_MAP() };

DECLARE_FRAME_WND_CLASS 有两个参数,窗口类名(可以为 NULL,ATL 会替你生成一个类名),和一个资源 ID。WTL 会根据此 ID 去寻找图标、菜单以及加速键表,并在窗口创建时加载它们。还会根据此 ID 寻找一个字符串,然后使用该串作为窗口的标题。我们还把消息串联到CFrameWindowImpl,因为它有自己的一些消息处理器,尤其是 WM_SIZE 和 WM_DESTROY。

现在我们来看 WinMain()。它和第一部分中的 WinMain() 极其类似,只是创建主窗口的调用存在差异。

// main.cpp:

#include \#include \

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;

}

CFrameWindowImpl 的 CreateEx() 方法采用了最常用的缺省值,因而我们不需要指定任何参数。CFrameWindowImpl 还会处理前文提到的资源加载事宜,所以现在你应该使用 IDR_MAINFRAME 这一 ID 生成一些伪资源,或者使用随本文附带的示例代码。

如果你马上运行,就可以看到主框架窗口了,当然,它实际上还没有做任何事情。我们需要加入一些消息处理器来干活儿,所以现在是研究 WTL 消息映射宏的好时机。

WTL 消息映射的增强

在使用 Win32 API 时,既令人讨厌又易于出错的事情之一就是从随消息一起发送过来的 WPARAM 和 LPARAM 数据中拆封参数。不幸的是,ATL 并未提供更多的帮助,除去 WM_COMMAND 和 WM_NOTIFY 之外,我们仍然需要从其他所有的消息中拆封数据。不过,WTL 正好在这儿对我们施以援手!

WTL 的增强消息映射宏在 atlcrack.h 文件中(此名字来源于 “message cracker”,是一个应用于 windowsx.h 中类似的宏的术语)。要使用这些宏的第一个步骤在 VC 6 和 VC 7 里是不一样的,在 atlcrack.h 中的以下提示解释了这一不同:

对于 ATL 3.0,使用了解拆处理器的消息映射必须使用 BEGIN_MSG_MAP_EX。 对于 ATL 7.0/7.1,你可以为 CWindowImpl/CDialogImpl 的派生类使

用 BEGIN_MSG_MAP,但是对于不是派生于CWindowImpl/CDialogImplbut 的类则必须使用 BEGIN_MSG_MAP_EX。

所以,如果你在使用 VC 6,你需要这样改动你的 MyWindow.h: // MyWindow.h, VC6 only:

class CMyWindow : public CFrameWindowImpl {

public:

BEGIN_MSG_MAP_EX(CMyWindow)

CHAIN_MSG_MAP(CFrameWindowImpl) END_MSG_MAP()

};

(_EX 宏对于 VC 6 来讲是必需的,因为包含于其中的某些代码是消息处理器宏需要使用的。出于可读性的原因,这里就不列出 VC 6 和 VC 7 版本的头文件了,因为它们仅仅是一个宏上面的不同。只需记住_EX 宏在 VC 7 里是不需要的即可。)

对我们的时钟程序来说,我们需要处理 WM_CREATE 并设置一个定时器。WTL 把针对一个消息的消息处理器命名为 MSG_ 后随消息名,比如MSG_WM_CREATE。这些宏仅接受处理器的名字。我们来为 WM_CREATE 添加一个处理器:

class CMyWindow : public CFrameWindowImpl {

public:

BEGIN_MSG_MAP_EX(CMyWindow) MSG_WM_CREATE(OnCreate)

CHAIN_MSG_MAP(CFrameWindowImpl) END_MSG_MAP()

// OnCreate(...) ? };

WTL 的消息处理器看起来很像 MFC,每个处理器都根据随消息传入的参数有一个不同的原型。不过,由于没有向导来写处理器,我们不得不自己来查找原型。幸运的是 VC 可以帮上忙。将光标(注:此处原文错误,不应该是光标[cursor],而应该是插入符[caret])放在 “MSG_WM_CREATE” 文本上再按 F12 会转到宏的定义处。在 VC 6 里,VC 会先重新编译工程以构建浏览信息数据库。这一工作一旦完成,VC 就会在 MSG_WM_CREATE 的定义处打开 atlcrack.h: #define MSG_WM_CREATE(func) \\ if (uMsg == WM_CREATE) \\ { \\

SetMsgHandled(TRUE); \\

lResult = (LRESULT)func((LPCREATESTRUCT)lParam); \\ if(IsMsgHandled()) \\ return TRUE; \\

}

带下划线的是最重要的一行,那是对处理器的实际调用,它告诉我们处理器会返回一个 LRESULT 并接受一个 LPCREATESTRUCT 类型的参数。注意,没有像 ATL 的宏所使用的 bHandled 参数。SetMsgHandled() 函数替代了该参数,很快我们就要解释这件事情。

现在我们可以为窗口类添加一个 OnCreate() 处理器:

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4