第一章 不能免俗的“Hello, World!”
在這一章里，就像所有的入門級教程一樣，我也將不能免俗地以一個“Hello, World!”程序開始我的教程。然后，我將逐步深入，向你介紹這個ATL版本程序中所有必要的信息。此外，我還將介紹一些Win32中你可能不知道的東西，包括WinMain的_t兼容以及如何在MessageBox中加入自己的圖標等等。
接近，接近，再接近……
可以說，所有“Hello, World!”程序的內容不外乎都是以十分有限的幾行代碼向當前的目標屏幕環境上輸出一個字符串“Hello, World!”。這個程序通常具有以下幾個特點：
- 排除印刷錯誤的可能性，幾乎所有的初學者都可以照葫蘆畫瓢地獨立書寫、編譯并運行這個程序。
- 這個程序可以體現出當前語言環境的典型配置方式。
- 這個程序中具有當前語言特定的程序入口點。
- 這個程序中含有一條當前環境典型的輸出語句（通常也是最簡單、最常用的），由這條語句來輸出“Hello, World!”字符串。
- 從這個程序可以很清楚的了解當前語言環境下程序運行的典型流程。
- 這個程序可能還會表現當前語言的一些其它特點。
那么，首先讓我以最簡單的C語言版“Hello, World!”開始吧：
#include <stdio.h>
int main()
{
printf( "Hello, World!n" );
return 0;
} |
雖然是不到10行的代碼，但它仍然五臟俱全。現在，就由我將它和上述的特點對號入座吧。也就是說，這個程序能體現出C程序設計的以下特點：
- C語言的程序以main函數作為程序入口點。
- printf是C中用來輸出字符串的代碼。
- 函數是C語言程序的基本單位，它通常由返回值、函數名、參數列表、函數體、return組成。
- 調用函數的時候要include相應的頭文件。
- n是C語言中的轉義字符，代表換行符。
接下來，我們來看一看Win32版的“Hello, World!”：
#include <windows.h>
int WINAPI WinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nShowCmd )
{
MessageBox( NULL, TEXT("Hello, World!"), TEXT("Hello"), 0 );
return 0;
} |
這個程序告訴你了以下幾件事：
- 所有Win32下的C程序都需要包含windows.h頭文件。
- Win32下的程序是以WinMain作為程序入口點的，而不是main。
- Win32下最常用輸出信息的方法是MessageBox。
- WINAPI是Win32 API函數的調用約定，也就是__stdcall。
- HINSTANCE、LPSTR都是Win32自定義的數據類型，分別表示應用程序實例句柄和以空字符結尾的ANSI字符串指針。
- TEXT宏用于在源代碼一級保證ANSI/Unicode字符串的兼容。
如果你對以上的幾個知識點仍然有些許迷茫，請參考Charles Petzold的《Programming Windows》（中譯《Windows程序設計》）的第一章。這段代碼就是幾乎原封不動地搬過來的。不過，我在編寫這段代碼的時候，通常會這么寫：
#include <windows.h>
#include <tchar.h>
int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
{
MessageBox( NULL, _T("Hello, World!"), _T("Hello"), 0 );
return 0;
} |
是的，有幾個地方有些不一樣，我對它們的解釋是：
- tchar.h中包含了對C runtime library中ANSI/Unicode字符串的源代碼級兼容。
- _tWinMain提供了對命令行參數lpCmdLine的ANSI/Unicode源碼級兼容。
- _T宏亦包含在tchar.h之中，它的作用和TEXT宏一樣，但它比TEXT宏更加短小，因此可以節省編碼的時間。
現在我可以告訴你，隨著我們的步步接近，接下來ATL版的“Hello, World!”程序就要出現在我們的眼前了。那么，就讓我們來看看這個猶抱琵琶半遮面的家伙吧。（請注意，雖然這是一個ATL版本的程序，但是你仍然需要建立一個Win32 Application的工程，而不是用ATL/COM Wizard。）
//////////////////////////////////////////////////////////////////////////
// ATL的GUI程序設計配套源代碼
// 第一章 不能免俗的“Hello, World!”
// 工程名稱：HelloWorld
// 作者：李馬
// http://www.titilima.cn
//////////////////////////////////////////////////////////////////////////
#include <atlbase.h>
CComModule _Module;
int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
{
_Module.Init( NULL, hInstance );
MessageBox( NULL, _T("Hello, World!"), _T("Hello"), 0 );
_Module.Term();
return 0;
} |
也許有些陌生了，不過所幸它并無太多的變化——畢竟整個代碼段就沒有多長。好了，這一節的內容就到這里，希望李馬的這種漸近的方法沒讓大家覺得一切來得太突然。大家可以喝口水先，然后做個深呼吸再，因為接下來我們就要開始接觸真正的ATL程序了。
“不過如此”
說句題外話先。許是我太狂妄，又許是我太幼稚，總之我在上大學以來，越來越喜歡說“不過如此”這句話。譬如上了大學以后，沒過倆月我就覺得大學“不過如此”；學會喝酒之后，就又會覺得喝酒“不過如此”；到了北京以后，又覺得北京“不過如此”；參觀了某著名軟件公司之后，又覺得它“不過如此”……書歸正傳話歸正題，不知道你第一眼看過ATL版本的“Hello, World!”之后會不會同樣有這樣一種感覺？——自然，我希望是這樣的。
那么，在了解ATL之前，就讓我們先來目測一下這個“Hello, World!”吧。也許，你會從上面的代碼猜到以下內容：
- atlbase.h大概其應該是ATL程序需要包含的頭文件。
- CComModule，從類名稱看應該是一個模塊類。_Module是這個模塊類的實例。
- WinMain沒變。
- CComModule::Init應該是對模塊進行初始化，這個方法應該是在程序初始化的時候調用。
- CComModule::Term應該是對模塊進行結束處理，這個方法應該是在程序結束之前調用。
- WinMain的最后仍然是以return結尾。
好，是不是“不過如此”呢？沒錯！
大抵如此
到此為止，希望你的猜想能夠讓你對ATL的恐懼感（如果有的話）一掃而光。那么，現在李馬來為你補充上幾點：
atlbase.h在用ATL進行GUI程序設計的時候，就如同SDK中的windows.h一樣重要。對于GUI程序設計的部分，這個文件中主要有這么幾個值得關注的地方：
- Win32程序設計必備的頭文件，諸如windows.h、tchar.h等。
- CComModule的定義。對于GUI程序設計，我們可以將它簡單地看作對HINSTANCE的一個封裝。
- 一些簡單的工具類。（請原諒我不能在這里提供給你它們具體的名字，因為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程序設計的時候，你只需要關心以下這些內容：
- HRESULT CComModule::Init( _ATL_OBJMAP_ENTRY* p, HINSTANCE h, const GUID* plibid = NULL );
進行模塊的初始化，第一個參數取NULL，第二個參數取應用程序的實例句柄，也就是WinMain中傳入的hInstance。
- void CComModule::Term();
進行模塊的卸載，在程序結束時調用。
- HINSTANCE CComModule::GetModuleInstance();
獲取應用程序實例句柄CComModule::m_hInst。
- HINSTANCE CComModule::GetResourceInstance();
獲取資源模塊句柄CComModule::m_hInstResource，這個值在默認情況下是和CComModule::m_hInst一致的。如果你程序的所有資源位于一個DLL之中，那么你可以在初始化應用程序中將CComModule::m_hInstResource成員賦值為這個DLL的模塊句柄。
接著說CComModule的實例_Module。可以說，這個全局變量貫穿于ATL整個框架的始終，無論你是使用它編寫COM組件還是GUI程序。譬如，你可能不止一次地需要使用模塊的實例句柄（LoadIcon、LoadCursor），那么你只需要這樣調用：
extern CComModule _Module;
HICON hIcon = ::LoadIcon( _Module.GetResourceInstance(), MAKEINTRESOURCE( IDI_YOURICON ) ); |
好了，那么現在我們可以充分展示一下這個模塊類的具體使用了。在此，我僅僅將我先前的“Hello, World!”作了一番擴展，如下：
//////////////////////////////////////////////////////////////////////////
// ATL的GUI程序設計配套源代碼
// 第一章 不能免俗的“Hello, World!”
// 工程名稱：HelloWorldEx
// 作者：李馬
// http://www.titilima.cn
//////////////////////////////////////////////////////////////////////////
#include <atlbase.h>
CComModule _Module;
int WINAPI _tWinMain( HINSTANCE hInstance, HINSTANCE hPrevInstance, LPTSTR lpCmdLine, int nShowCmd )
{
_Module.Init( NULL, hInstance );
_Module.m_hInstResource = LoadLibrary( _T("shell32.dll") );
MSGBOXPARAMS mbp;
ZeroMemory( &mbp, sizeof( mbp ) );
mbp.cbSize = sizeof( mbp );
mbp.dwLanguageId = GetSystemDefaultLangID();
mbp.dwStyle = MB_USERICON;
mbp.hInstance = _Module.GetResourceInstance();
mbp.lpszCaption = _T("Hello");
mbp.lpszIcon = MAKEINTRESOURCE( 44 );
mbp.lpszText = _T("Hello, World!");
MessageBoxIndirect( &mbp );
FreeLibrary( _Module.m_hInstResource );
_Module.m_hInstResource = NULL;
_Module.Term();
return 0;
} |
這個程序運行起來是這個樣子：
如你所見，在這里我使用了來自應用程序之外的資源，也就是對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開發的工具類。這些內容與本書無關，而且李馬也自認現在尚無能力來解說這些內容，所以一并從略了就。