ATL的GUI程序设计(1)

from：http://blog.titilima.com/atlgui-1.html

第一章 不能免俗的“Hello, World!”

在这一章里，就像所有的入门级教程一样，我也将不能免俗地以一个“Hello, World!”程序开始我的教程。然后，我将逐步深入，向你介绍这个ATL版本程序中所有必要的信息。此外，我还将介绍一些Win32中你可能不知道的东西，包括WinMain的_t兼容以及如何在MessageBox中加入自己的图标等等。

接近，接近，再接近……

可以说，所有“Hello, World!”程序的内容不外乎都是以十分有限的几行代码向当前的目标屏幕环境上输出一个字符串“Hello, World!”。这个程序通常具有以下几个特点：

1. 排除印刷错误的可能性，几乎所有的初学者都可以照葫芦画瓢地独立书写、编译并运行这个程序。
2. 这个程序可以体现出当前语言环境的典型配置方式。
3. 这个程序中具有当前语言特定的程序入口点。
4. 这个程序中含有一条当前环境典型的输出语句（通常也是最简单、最常用的），由这条语句来输出“Hello, World!”字符串。
5. 从这个程序可以很清楚的了解当前语言环境下程序运行的典型流程。
6. 这个程序可能还会表现当前语言的一些其它特点。

那么，首先让我以最简单的C语言版“Hello, World!”开始吧：

C++代码

1. #include <stdio.h>
2. int main()
3. {
4. printf( "Hello, World! " );
5. return 0;
6. }

虽然是不到10行的代码，但它仍然五脏俱全。现在，就由我将它和上述的特点对号入座吧。也就是说，这个程序能体现出C程序设计的以下特点：

1. C语言的程序以main函数作为程序入口点。
2. printf是C中用来输出字符串的代码。
3. 函数是C语言程序的基本单位，它通常由返回值、函数名、参数列表、函数体、return组成。
4. 调用函数的时候要include相应的头文件。
5. 是C语言中的转义字符，代表换行符。

接下来，我们来看一看Win32版的“Hello, World!”：

C++代码

1. #include <windows.h>
2. int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd )
3. {
4. MessageBox( NULL, TEXT("Hello, World!"), TEXT("Hello"), 0 );
5. return 0;
6. }

这个程序告诉你了以下几件事：

1. 所有Win32下的C程序都需要包含windows.h头文件。
2. Win32下的程序是以WinMain作为程序入口点的，而不是main。
3. Win32下最常用输出信息的方法是MessageBox。
4. WINAPI是Win32 API函数的调用约定，也就是__stdcall。
5. HINSTANCE、LPSTR都是Win32自定义的数据类型，分别表示应用程序实例句柄和以空字符结尾的ANSI字符串指针。
6. TEXT宏用于在源代码一级保证ANSI/Unicode字符串的兼容。

如果你对以上的几个知识点仍然有些许迷茫，请参考Charles Petzold的《Programming Windows》（中译《Windows程序设计》）的第一章。这段代码就是几乎原封不动地搬过来的。不过，我在编写这段代码的时候，通常会这么写：

C++代码

1. #include <windows.h>
2. #include <tchar.h>
3. int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
4. {
5. MessageBox( NULL, _T("Hello, World!"), _T("Hello"), 0 );
6. return 0;
7. }

是的，有几个地方有些不一样，我对它们的解释是：

1. tchar.h中包含了对C runtime library中ANSI/Unicode字符串的源代码级兼容。
2. _tWinMain提供了对命令行参数lpCmdLine的ANSI/Unicode源码级兼容。
3. _T宏亦包含在tchar.h之中，它的作用和TEXT宏一样，但它比TEXT宏更加短小，因此可以节省编码的时间。

现在我可以告诉你，随着我们的步步接近，接下来ATL版的“Hello, World!”程序就要出现在我们的眼前了。那么，就让我们来看看这个犹抱琵琶半遮面的家伙吧。（请注意，虽然这是一个ATL版本的程序，但是你仍然需要建立一个Win32 Application的工程，而不是用ATL/COM Wizard。）

C++代码

1. //////////////////////////////////////////////////////////////////////////
2. // ATL的GUI程序设计配套源代码
3. // 第一章 不能免俗的“Hello, World!”
4. // 工程名称：HelloWorld
5. // 作者：李马
6. // http://www.titilima.cn
7. //////////////////////////////////////////////////////////////////////////
8. #include <atlbase.h>
9. CComModule _Module;
10. int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
11. {
12. _Module.Init( NULL, hInstance );
13. MessageBox( NULL, _T("Hello, World!"), _T("Hello"), 0 );
14. _Module.Term();
15. return 0;
16. }

也许有些陌生了，不过所幸它并无太多的变化——毕竟整个代码段就没有多长。好了，这一节的内容就到这里，希望李马的这种渐近的方法没让大家觉得一切来得太突然。大家可以喝口水先，然后做个深呼吸再，因为接下来我们就要开始接触真正的ATL程序了。

“不过如此”

说句题外话先。许是我太狂妄，又许是我太幼稚，总之我在上大学以来，越来越喜欢说“不过如此”这句话。譬如上了大学以后，没过俩月我就觉得大学“不过如此”；学会喝酒之后，就又会觉得喝酒“不过如此”；到了北京以后，又觉得北京“不过如此”；参观了某著名软件公司之后，又觉得它“不过如此”……书归正传话归正题，不知道你第一眼看过ATL版本的“Hello, World!”之后会不会同样有这样一种感觉？——自然，我希望是这样的。

那么，在了解ATL之前，就让我们先来目测一下这个“Hello, World!”吧。也许，你会从上面的代码猜到以下内容：

1. atlbase.h大概其应该是ATL程序需要包含的头文件。
2. CComModule，从类名称看应该是一个模块类。_Module是这个模块类的实例。
3. WinMain没变。
4. CComModule::Init应该是对模块进行初始化，这个方法应该是在程序初始化的时候调用。
5. CComModule::Term应该是对模块进行结束处理，这个方法应该是在程序结束之前调用。
6. WinMain的最后仍然是以return结尾。

好，是不是“不过如此”呢？没错！

大抵如此

到此为止，希望你的猜想能够让你对ATL的恐惧感（如果有的话）一扫而光。那么，现在李马来为你补充上几点：

atlbase.h在用ATL进行GUI程序设计的时候，就如同SDK中的windows.h一样重要。对于GUI程序设计的部分，这个文件中主要有这么几个值得关注的地方：

1. Win32程序设计必备的头文件，诸如windows.h、tchar.h等。
2. CComModule的定义。对于GUI程序设计，我们可以将它简单地看作对HINSTANCE的一个封装。
3. 一些简单的工具类。（请原谅我不能在这里提供给你它们具体的名字，因为ATL 3.0和ATL 7.0是不一样的。VC 6.0附带的是ATL 3.0，它的atlbase.h中主要提供了一些COM的智能指针和字符串，如CComPtr、CComBSTR等；而VS2003中的ATL 7.0中则附带了一些更有趣的类，比如CRegKey、CHandle等。）

下面接着说CComModule。相信你可以从它的类名称中看出来，这个类主要用来管理COM的各种信息。如果你深入到ATL的源代码之中，你可能会为它的众多成员与方法感觉到迷惑。其实在进行GUI程序设计的时候，你只需要关心以下这些内容：

1. HRESULT CComModule::Init( _ATL_OBJMAP_ENTRY* p, HINSTANCE h, const GUID* plibid = NULL );
   
   进行模块的初始化，第一个参数取NULL，第二个参数取应用程序的实例句柄，也就是WinMain中传入的hInstance。
2. void CComModule::Term();
   
   进行模块的卸载，在程序结束时调用。
3. HINSTANCE CComModule::GetModuleInstance();
   
   获取应用程序实例句柄CComModule::m_hInst。
4. HINSTANCE CComModule::GetResourceInstance();
   
   获取资源模块句柄CComModule::m_hInstResource，这个值在默认情况下是和CComModule::m_hInst一致的。如果你程序的所有资源位于一个DLL之中，那么你可以在初始化应用程序中将CComModule::m_hInstResource成员赋值为这个DLL的模块句柄。

接着说CComModule的实例_Module。可以说，这个全局变量贯穿于ATL整个框架的始终，无论你是使用它编写COM组件还是GUI程序。譬如，你可能不止一次地需要使用模块的实例句柄（LoadIcon、LoadCursor），那么你只需要这样调用：

C++代码

1. extern CComModule _Module;
2. HICON hIcon = ::LoadIcon( _Module.GetResourceInstance(), MAKEINTRESOURCE( IDI_YOURICON ) );

好了，那么现在我们可以充分展示一下这个模块类的具体使用了。在此，我仅仅将我先前的“Hello, World!”作了一番扩展，如下：

C++代码

1. //////////////////////////////////////////////////////////////////////////
2. // ATL的GUI程序设计配套源代码
3. // 第一章 不能免俗的“Hello, World!”
4. // 工程名称：HelloWorldEx
5. // 作者：李马
6. // http://www.titilima.cn
7. //////////////////////////////////////////////////////////////////////////
8. #include <atlbase.h>
9. CComModule _Module;
10. int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
11. {
12. _Module.Init( NULL, hInstance );
13. _Module.m_hInstResource = LoadLibrary( _T("shell32.dll") );
14. MSGBOXPARAMS mbp;
15. ZeroMemory( &mbp, sizeof( mbp ) );
16. mbp.cbSize       = sizeof( mbp );
17. mbp.dwLanguageId = GetSystemDefaultLangID();
18. mbp.dwStyle      = MB_USERICON;
19. mbp.hInstance    = _Module.GetResourceInstance();
20. mbp.lpszCaption  = _T("Hello");
21. mbp.lpszIcon     = MAKEINTRESOURCE( 44 );
22. mbp.lpszText     = _T("Hello, World!");
23. MessageBoxIndirect( &mbp );
24. FreeLibrary( _Module.m_hInstResource );
25. _Module.m_hInstResource = NULL;
26. _Module.Term();
27. return 0;
28. }

这个程序运行起来是这个样子：

如你所见，在这里我使用了来自应用程序之外的资源，也就是对CComModule::GetModuleInstance进行了特殊处理。WTL就是对CComModule这个类进行了继承处理而派生出了CAppModule类，使之成为了更适合应用程序使用的模块类。有兴趣的朋友可以参看WTL附带的atlapp.h文件，我这里就不多说了。

“貌合神离”

字典上对这个词的解释是：“表面上很亲密而实际上怀有二心”。在此，我将它用在ATL 3.0与7.0上，用来表示它们俩“用法兼容而实现迥异”的既有事实。不过，对于GUI程序设计而言，你并不需要深入了解这方面的内容。因此我这里列举的，也只是与GUI有关的部分。

• ATL 3.0之中，CComModule直接继承自_ATL_MODULE；而ATL 7.0之中，CComModule则经历了一串的继承链。
• 相比之下，ATL 7.0中的CComModule更有COM的味道，譬如它的ModuleInstance、ResourceInstance都可以作为COM组件的property，使用get、put来处理。

当然，ATL毕竟是一个为开发COM组件而构建的Framework，所以ATL 7.0中的atlbase.h之中还包含了更多有关COM开发的工具类。这些内容与本书无关，而且李马也自认现在尚无能力来解说这些内容，所以一并从略了就。

附件：atlgui01.zip