本文譯自
codeproject.com,原文鏈接與工具及其源代碼下載點(diǎn)擊
這里。
-----------------------------------
?
導(dǎo)引:WINDOWSX.H頭文件簡化Win32 SDK編程許多的新手或者調(diào)試程序員在編寫C/C++的Windows API程序時都要面對像意大利面一樣的
switch...case代碼塊。當(dāng)你需要加入一個消息處理到你的窗口處理過程中時,在些代碼塊中查找例如:WM_COMMAND或WM_CHAR,是相當(dāng)讓人恐懼的事情。
早在Windows 3.1時代的Windows軟件開發(fā)工具包和C/C++7.0編譯器就附帶一個包含一千多行Windows處理代碼的頭文件。這個頭文件是<windowsX.h>,它包含
了許多有用的宏。微軟的對這個頭文件的介紹如下:
- 對C程序做更嚴(yán)格的類型檢查的STRICT宏。
- 一些簡化Windows編程的通用操作的宏。
- 一些簡化與Windows控件交流的控件宏。
- 消息分流器(一種方便,輕便并且類型安全的處理消息的方法)以及它們在Windows環(huán)境下的參數(shù)和返回值。
在Message Cracker Wizard被設(shè)計(jì)出現(xiàn)之前,我就從使用這些的宏中獲得了效率。如果你對
Windows.h的簡單描述感興趣,你可以參見MS知識庫的文章
#8356 。
好了,讓我們來介紹消息分流器的便利,以及,為什么這里發(fā)布的工具可以你編寫代碼的效率。
當(dāng)你在編寫Win32 SDK程序時,你處理窗口消息通過一個窗口函數(shù),通常命名為
WndProc。在Windows C 程序中常見的是窗口函數(shù)通過關(guān)鍵字switch和分支標(biāo)簽case處理所有你需要處理的消息。
可以料想的是我們通常需要在主窗口中處理WM_COMMAND,WM_KEYUP,WM_CLOSE和WM_DESTROY消息。理論上我們會把窗口函數(shù)寫成這樣:
LRESULT?CALLBACK?MainWndProc?(HWND?hwnd,?UINT?msg,???WPARAM?wParam,?LPARAM?lParam)
{
??switch(msg)
??{
????case?WM_COMMAND:
????//?
????break;????
?????
????case?WM_KEYUP:
????//?
????break;
????case?WM_CLOSE:
????//?
????break;???????
?????
????case?WM_DESTROY:
????//
????break;??????
????????
????default:???
???????return?DefWindowProc(hwnd,?msg,?wParam,?lParam);
??}
}
這是自Windows 1.0時代以來處理Windows消息使用最多的,確實(shí)地,它工作。但是問題是當(dāng)你開始向你程序中加入更多復(fù)雜的特性,例如 MDI,OLE,通用控件,等等,你會獲得一個行數(shù)以千記的窗口函數(shù)。你開始反復(fù)使用PageDn和PageUp鍵跳躍,來尋找你需要修改的消息。
這是使用消息分流器的第一個好處:它們提供了處理函數(shù)來簡化
case標(biāo)簽意大利面,就像MFC做的那樣。
第二個好處是正確的參數(shù)規(guī)范化了你的處理函數(shù)的使用。你可以簡單地使用switch(id)來替代switch(LOWORD(wparam)),因?yàn)槟惆?span style="COLOR: rgb(204,0,0)">id作為一個“分流器”的參數(shù)傳遞給消息函數(shù)時,等同于LOWORD(wparam)。
消息處理宏HANDLE_MSG定義在windows.h中,如下:
#define?HANDLE_MSG(hwnd,?message,?fn)?\
????case?(message)?:?return?HANDLE_##message((hwnd),?(wParam),?(lParam),?(fn))?
如你從上面宏定義中可以想到的是,將你的代碼轉(zhuǎn)換成“消息分流器”版本,你必須支持分流宏,HANDLE_MSG,并且使用函數(shù)來處理消息?,F(xiàn)在將HANDLE_MSG宏加入到窗口函數(shù)中來。這個宏需要三個參數(shù):一個窗口句柄(hwnd),你要處理的消息(WM_xxxx),以及你用來處理此消息的函數(shù)。為了更好的說明,我把之前的窗口函數(shù)替換成下面的消息分流版:
LRESULT?CALLBACK?MainWndProc?(HWND?hwnd,?UINT?msg,?WPARAM?wParam,?LPARAM?lParam)
{
??switch(msg)
??{
????HANDLE_MSG?(hwnd,?WM_COMMAND,?OnCommand);
????HANDLE_MSG?(hwnd,?WM_KEYUP,???OnKeyup);
????HANDLE_MSG?(hwnd,?WM_CLOSE,???OnClose);
????HANDLE_MSG?(hwnd,?WM_DESTROY,?OnDestroy);
????default:
????????return?DefWindowProc(hwnd,?msg,?wParam,?lParam);
??}
}
哇!這是更好的,簡潔的并且容易控制的窗口函數(shù)?,F(xiàn)在你需要定義的的消息處理函數(shù)(
OnKeyUp, OnClose和OnDestroy)。更加便利的是你可以使用Visual Studio IDE跳到你消息處理函數(shù):

問題是每一次你增加一個消息處理你都必須搜尋
WINDOWS.H里的定義,以匹配你的消息處理函數(shù)的參數(shù)類型,因?yàn)槟悴荒茈S意的使用參數(shù)類型:處理函數(shù)的格式是清楚定義的。在頭文件中反復(fù)的查找是單調(diào)乏味的任務(wù),且容易出錯。消息分流器Wizard工具來搭救你了:它允許你粘貼任何你需要的消息處理的正確的參數(shù)。如果你剛剛開始編寫代碼,它還可以生成一個窗口模板或者對話框函數(shù)作為你處理窗口消息的開始。
Message forwarding宏:另一個WINDOWS.H特色
頭文件windowsx.h的另一個特色大約是message forwarding。它用來“拆除”消息處理函數(shù)的參數(shù)為有效的WPARAM和LPARAM的值,以調(diào)用諸如PostMessage,SendMessage,CallWindowProc等等,此類的函數(shù)。
假設(shè)你你希望使用SendMessage函數(shù)來發(fā)送WM_COMMAND消息給父窗口,通過以一個通知碼BN_DBLCLK來“模擬”雙擊一個命名為IDC_USERCTL的控件。你通常會這樣寫:
SendMessage (hwndParent, WM_COMMAND,
??? MAKEWPARAM(IDC_USERCTL, BN_DBLCLK),
???? (LPARAM)GetDlgItem(hwnd, ID_USERCTL));
這是一個復(fù)雜的的語法:函數(shù)SendMessage期望WPARAM參數(shù)的底字節(jié)是控件的ID,高字節(jié)是通知碼;并且我們要通過API函數(shù)GetDlgItem獲得控件句柄,傳給LPARAM參數(shù)。
上面的代碼可以用Windows.h的message forwarding宏替換,FORWARD_WM_XXXX。對于每一個消息,forwarding宏都使用和消息分流器生成的消息處理函數(shù)相同的“捆扎”參數(shù),增加你希望調(diào)用的函數(shù)并且傳給它“拆除”后的LPARAM/WPARAMs。例如,消息分流器Wizard為WM_COMMAND消息和窗口IDmyWnd生成如下的函數(shù)原型:
void myWnd_OnCommand (HWND hwnd, int id, HWND hwndCtl, UINT codeNotify)
好了,這些分流器參數(shù)也同樣被用于forwarding宏--因此,如你所期望的,我們之前調(diào)用SendMessage函數(shù)時展現(xiàn)的混亂可以減少了:
FORWARD_WM_COMMAND (hwndParent, IDC_USERCTL,
GetDlgItem(hwnd, ID_USERCTL), BN_DBLCLK, SendMessage);
這種方式非常簡便,并且可以為所有消息分流器Wizard支持的消息工作。
使用消息分流Wizard工具
當(dāng)你運(yùn)行消息分流器Wizard時,你可以看到下面的窗口:

Wizard在左上角的列表框里為你提供了WINDOWS.H里有的消息處理,你可以點(diǎn)擊一個或者多個消息。你可以在窗口ID編輯框里指定一個窗口標(biāo)識,以指定你要發(fā)送消息的
窗口。通用的ID有 MainWnd ,About (關(guān)于對話框),等等。這個標(biāo)識會體現(xiàn)在消息處理函數(shù)中,和 HANDLE_MSG 宏中,如果你剛剛開始編寫代碼,它還可以體現(xiàn)在窗
口/對話框處理函數(shù)中?!?Make Window Procedure”選定框的作用是:允許你通過選定的消息分流器的宏來生成一個窗口/對話框函數(shù)的框架。以這種方式來開始一
個Windows API項(xiàng)目,你可以清晰的編寫和組織你的代碼,當(dāng)然還有,避免錯誤。在窗口下面的兩個編輯框會包含分流器的宏和處理所選消息的函數(shù)(只是原型)生成的代
碼。要注意的是,當(dāng)你選擇“Make Window Procedure”時窗口處理函數(shù)的模板代碼不出現(xiàn)在這里:它僅體現(xiàn)在你點(diǎn)擊了“Copy Macro”時復(fù)制到你的C++編輯器中
的代碼里。
讓我們通過例子來快速的瀏覽消息分流器Wizard工具的特性。記住你必須先通過#include <windowsx.h>將頭文件<windowsx.h>包含到你.C/.CPP文件中。
快速瀏覽消息分流器Wizard特性
讓我們開始吧。假設(shè)你已經(jīng)編寫了你的 WinMain 的基本代碼:已經(jīng)成功填充了 WNDCLASS 結(jié)構(gòu),注冊了窗口類,并且編寫了消息循環(huán)。現(xiàn)在你需要一個為你主函數(shù)編寫
的消息處理函數(shù)。
打開消息分流器Wizard。我們需要為我們的窗口選擇消息,因?yàn)镸CW需要用它來生成我們的消息處理函數(shù)。如你所知,Windows程序非常常見的處理消息是 WM_CLOSE 和
WM_DESTROY 和 WM_CREATE ,所以讓我們選擇消息分流器處理這些消息來創(chuàng)建窗口函數(shù)。然后,我們創(chuàng)建窗口函數(shù)的主體消息處理函數(shù)。
在列表框中選擇 WM_CLOSE , WM_DESTROY 和 WM_CREATE 。因?yàn)榇舜翱谑俏覀兂绦虻闹鞔翱冢覀冞x用main做為窗口的ID。這個窗口ID表識了我們的窗口/對話框,并且
使分流宏和出理函數(shù)作為后綴。當(dāng)然,你要使特定窗口的所有消息處理保持一致。觀察下面的編輯框。它們顯示 HANDLE_MSG 分流宏和關(guān)聯(lián)的消息處理函數(shù)的原型。

但是,等一下......我們說我們需要一個準(zhǔn)備好的窗口處理函數(shù)。所以單擊“Make Window Procedure”選定框,并且確認(rèn)Window 單選按鈕已經(jīng)被選擇了?,F(xiàn)在
我們準(zhǔn)備好了。要注意的是,對話框的工作也像這樣,但是要改變處理函數(shù)為對話框類型。
首先,我們需要我們源代碼的窗口處理函數(shù)。點(diǎn)擊“Copy Macro”按鈕(或者使用Ctrl-M),最小化Wizard(或者把它放到一邊),回到你的IDE并且從剪貼板粘貼
(Ctrl-V)代碼到你的窗口函數(shù)的位置。Voilá(阿根廷拉丁語,認(rèn)識的通知下)!你可以得到像下面的代碼:
//
//?main??Window?Procedure
//
LRESULT?CALLBACK?main_WndProc?(HWND?hwnd,?UINT?msg,?WPARAM?wParam,???LPARAM?lParam)
{
??switch(msg)
??{
????HANDLE_MSG?(hwnd,?WM_CLOSE,?main_OnClose);
????HANDLE_MSG?(hwnd,?WM_CREATE,?main_OnCreate);
????HANDLE_MSG?(hwnd,?WM_DESTROY,?main_OnDestroy);
??????////?TODO:?Add?window?message?crackers?here
??default:?return?DefWindowProc?(hwnd,?msg,?wParam,?lParam);
??}
}
這個窗口處理函數(shù)以三個消息分流宏展開工作!并且,通過TODO注釋提示你記得必須在這里添加消息分流器宏。當(dāng)你只是要添加一個 HANDLE_MSG 宏到窗口函數(shù)中時,
記得取消“Mke Window Procedure”選定框的選擇。
但是這些代碼現(xiàn)在還什么都做不了,因?yàn)槲覀冞€需要添加三個我們需要的消息處理函數(shù)?;氐较⒎至髌鱓izard工具的界面,并且單擊“Copy Function”按鈕。切
換到你的代碼,用鼠標(biāo)定位到你需要函數(shù)主體插入的位置,然后用Ctrl+V或者菜單Edit/Paste粘貼。Wizard自動生成函數(shù),使用 main 標(biāo)識窗口ID,并修正參數(shù)類型
使之符合 WINDOWSX.H 頭文件的宏:
//
//Process?WM_CLOSE?message?for?window/dialog:?main
//
void?main_OnClose(HWND?hwnd)
{
??//?TODO:?Add?your?message?processing?code?here
}
//
//??Process?WM_CREATE?message?for?window/dialog:?main
//
BOOL?main_OnCreate(HWND?hwnd,?LPCREATESTRUCT?lpCreateStruct)
{
??//?TODO:?Add?your?message?processing?code?here
}
//
//??Process?WM_DESTROY?message?for?window/dialog:?main
//
void?main_OnDestroy(HWND?hwnd)
{
??//?TODO:?Add?your?message?processing?code?here
}
Wizard還可以自動生成開頭注釋,和TODO行以提醒你添加代碼?,F(xiàn)在你可以添加消息處理了,可以是簡單的處理處理邏輯,或者復(fù)雜窗口函數(shù)。你也可以通過選定框移除
注釋。
更多的消息分流器Wizard特性
消息過濾
你可以過濾你暫時不打算處理的消息。單擊“Filters..”按鈕(或者Ctrl+L),你會打開下面對話框。列表的消息按類型分類(分類標(biāo)準(zhǔn)來自Microsoft Spy++的效果),
你可以取消選定你不處理的消息。

要注意的是在 v2.0 當(dāng)前的問題是,當(dāng)你打開消息過濾對話框時所有類型的消息都是選定的,當(dāng)你點(diǎn)擊OK,之前選定的消息會丟失(這并不意味著你粘貼到目標(biāo)代碼的
內(nèi)容會消失)。
簡潔窗口模式
你可能需要減小消息分流Wizard窗體的大小。這可以通過取消菜單 View 的 “Show Target Code”選項(xiàng)的選定(或者使用Ctrl+F11)。主窗口會取消目標(biāo)代碼區(qū)域:
窗體透明,取消注釋和置頂
(譯注:Sorry,暫不做翻譯了,你可以通過嘗試菜單 View 的其它幾個選項(xiàng)自己體會^_^)
未來特性
下面的特性會在下一次發(fā)布時實(shí)現(xiàn):
- 幫助文件。
- 所有消息分流的參數(shù)和消息的完整幫助。
- 支持WTL!:)
- 窗口ID和配置保存(這個會在下一個2.x版本實(shí)現(xiàn))。
- 項(xiàng)目配置和“消息映射”(a la MFC)(譯注:好像是西班牙語,不認(rèn)識:P)(這個也會在之后的2.5版本實(shí)現(xiàn))。
快樂的編程!
我希望這個小工具可以讓每個 Windows SDK 程序員感興趣,并且干凈的編寫 Win32 API 程序。我樂于接受改進(jìn)這個工具的主意。如果你發(fā)現(xiàn)這個程序很好用,請給我發(fā)郵件,因?yàn)槲曳浅8吲d聽到任何好的意見。
謝謝所有支持??!You know who you are?。ㄗg注:不太明白這個要表達(dá)什么意思,“你知道你是誰!”乎?)
任何時候,打開我的主頁,你可以在那里找到這個程序的最新更新。
歷史:
? 略...
關(guān)于作者:Hernán Di Pietro
業(yè)余程序員。
開始于1986年,在Commodore 64上編寫B(tài)ASIC程序。
在1990年第一臺 8086 PC 上開始編寫 QB 4.x。
1995-1996年轉(zhuǎn)移到Visual Basic。
2002年,23歲時開始編寫C++程序,并對 Windows API 上癮。
主頁: http://usuarios.lycos.es/hernando
posted on 2006-11-02 00:00
小山日志 閱讀(1262)
評論(3) 編輯 收藏 引用 所屬分類:
windows program