Win32編程點滴：消息循環（Message loop）

第一個版本

首先讓我們來寫一個最容易讓人想到的消息循環的形式：

MSG　 msg
while(　GetMessage(&msg,NULL,0,0)　)
{
　TranslateMessage (&msg);
　DispatchMessage(&msg);
}

GetMessage函數第一 個參數是用來獲取MSG結構的指針。第二個參數是一個窗口句柄（HWND），用來獲取指定窗口的消息，填 NULL表示獲取當前線程所有窗口的消息或者線程消息（Thread message）。最後兩個參數是 wMsgFilterMin和wMsgFilterMax，用來獲取指定的消息，當都填0則表示獲取所有的消息。

TranslateMessage函數根據WM_KEYUP,WM_KEYDOWN之類的時間，生成相應的WM_CHAR之類的消息。

DispatchMessage函數將窗口消息，交給相應的窗口過程（WindowProc）來處理。

以上的 這個消息循環，在大部分情況下都能工作得很好，尤其是一般寫點小程序，寫成上面的形式完全沒有問 題。不過偶爾可能會出些問題，所以請繼續往下看，還有哪些改進的余地。

第二個版本

如果我們仔細的看一下MSDN上關於GetMessage函數的說明，那麼就可以看到MSDN指出了 while( GetMessage(...) ) 的方式是錯誤的，並給出了如下的形式：

BOOL　bRet;

while(　(bRet　=　GetMessage(　&msg,　NULL,　0,　0　))　!=　0)
{　
　if　(bRet　==　-1)
　{
　　//　handle　the　error　and　 possibly　exit
　}
　else
　{
　　TranslateMessage(&msg);
　　DispatchMessage(&msg);
　}
}

原來GetMessage除了在收到WM_QUIT消息的時候返回0之外，在發生錯誤的時候返回的是-1。在大部分 情況下，即使發生了錯誤，msg也保存了上一次的消息，一個消息處理了兩次，我想大部分人都不會察覺 到吧。不過，如果我們想自己寫一個類似於MFC之類的框架程序或者嚴於律己的人來說，這點程序的健壯 性還是不容忽略的。

在繼續下一個版本的改進以前，現在模仿MFC或WTL，做一個 PreTranslateMessage：

BOOL　PreTranslateMessage(LPMSG　pMsg)
{
　return　FALSE;
}

BOOL　bRet;
while(　(bRet　=　GetMessage(　 &msg,　NULL,　0,　0　))　!=　0)
{　
　if　(bRet　==　-1)
　{
　　//　handle　the　error　and　possibly　exit
　}
　else　if　(!PreTranslaeMessage(&msg))
　{
　　TranslateMessage(&msg);
　　DispatchMessage(&msg);
　}
}

PreTranslateMessage函數的作用是非常重要的。由於DispatchMessage函數是將 消息分發給各個窗口過程（WindowProc）處理，我覺得有3種情況要放在PreTranslateMessage裡處理：

全局性的東西，不適宜或不方便放在窗口過程中處理的東西。

要處理某些第三方或通用 控件的消息。

線程消息。

下面要講的東西，都將放在PreTranslateMessage函數中。

第三個版本

首先要放在PreTraslateMessage函數中的，屬於上面3中情況的第一條，全 局性的東西，快捷鍵。

HACCEL　hAcc　=　LoadAccelerator(hInst,MAKEINTRESOURCE (IDA_XXX));

BOOL　PreTranslateMessage(LPMSG　pMsg)
{
　if(TranslateAccelerator(hWnd,hAcc,pMsg))　
　　return　TRUE;
　return　FALSE;
}

這裡要注意的是，除了自己程序定義的快捷鍵之外，很多ActiveX控件，都暴露出了有 TranslateAccelerator的接口。如果沒有在PreTranslateMessage中調用的話，那程序一定會缺乏某些使 人不方便的行為，比如tab鍵導航。尤其是嵌入了webbrowser控件的程序,如果想讓用戶舒適得使用這個 內嵌的浏覽器的話，一定要調用下面類似的代碼：

IWebBrowser2　*　m_pBrowser;

BOOL　PreTranslateMessage(LPMSG　pMsg)
{
　IOleInPlaceActiveObject 　*　pObj;
　if(　SUCCESSED(m_pBrowser->QueryInterface (IID_IOleInPlaceActiveObject,&pObj))　&&
　S_OK　==　pObj- >TranslateAccelerator(pMsg))
　{
　　return　TRUE;
　}
　return　FALSE;
}

第四個版本

如果不查MSDN，是否 能立刻說出IsDialogMessage函數的作用呢？IsDialogMessage函數並不僅僅是一個IsXXX的函數，它的作 用是：判斷一個消息是否為一個對話框的消息，如果是，就處理它。所以，代碼應該如下：

BOOL　PreTranslateMessage(LPMSG　pMsg)
{
　if(IsDialogMessage(hDlg,pMsg))
　　return　TRUE;
　return　 FALSE;
}

IsDialogMessage是用來處理對話框上面控件的鍵盤導航的。例如：當焦 點在一個按鈕上面的時候，按下tab鍵，這時應該將焦點設到下一個控件上面，而由於焦點在這個按鈕上 面，所以只有這個按鈕才收得到這個tab鍵的鍵盤消息，因此我們需要在消息循環中也就是 PreTranslateMessage中調用IsDialogMessage來處理這樣的消息。

一般而言，上面的hDlg參數，是一個當前存在的非模態窗口。當然，如MSDN所說，如果一個普通的窗 口上面的控件需要使用鍵盤導航的話，也可以調用IsDialogMessage來處理。那麼，為什麼上面指定的是 非模態窗口，模態窗口不需要了嗎？是的，因為模態窗口自帶消息循環，用不著我們自己的消息循環。

第五個版本？

我想我暫時是想不出第五個版本了，即便是一個簡簡單單的消息循環，也 還有很多深層次的東西可以挖掘。我們平時用慣了MFC/ATL/WTL之類的框架，它們已經將消息循環封裝的 很好了，很多東西都已經自動處理了。我想，雖然有些東西我們不需要親自處理，但是還是需要對此有 一定了解的。

最後，就已WTL的消息循環的源代碼，結束這篇文章吧：

////////////////////////////////////////////////////////////////////////////// /
//　CMessageLoop　-　message　loop　implementation

class　CMessageLoop
{
public:
　　　　ATL::CSimpleArray<CMessageFilter*>　m_aMsgFilter;
　　　　ATL::CSimpleArray<CIdleHandler*>　m_aIdleHandler;
　　　　MSG　m_msg;

//　Message　filter　operations
　　　　BOOL　AddMessageFilter(CMessageFilter* 　pMessageFilter)
　　　　{
　　　　　　　　return　m_aMsgFilter.Add (pMessageFilter);
　　　　}

　　　　BOOL　RemoveMessageFilter (CMessageFilter*　pMessageFilter)
　　　　{
　　　　　　　　return　 m_aMsgFilter.Remove(pMessageFilter);
　　　　}

//　Idle　handler　 operations
　　　　BOOL　AddIdleHandler(CIdleHandler*　pIdleHandler)
　　　　{
　　　　　　　　return　m_aIdleHandler.Add(pIdleHandler);
　　　　}

　　 　　BOOL　RemoveIdleHandler(CIdleHandler*　pIdleHandler)
　　　　{
　　　　　　　 　return　m_aIdleHandler.Remove(pIdleHandler);
　　　　}

#ifndef　 _ATL_NO_OLD_NAMES
　　　　//　for　compatilibility　with　old　names　only
　　　 　BOOL　AddUpdateUI(CIdleHandler*　pIdleHandler)
　　　　{
　　　　　　　　 ATLTRACE2(atlTraceUI,　0,　_T("CUpdateUIObject　and　AddUpdateUI　are　deprecated.　 Please　change　your　code　to　use　CIdleHandler　and　OnIdle\n"));
　　　　　　 　　return　AddIdleHandler(pIdleHandler);
　　　　}

　　　　BOOL　 RemoveUpdateUI(CIdleHandler*　pIdleHandler)
　　　　{
　　　　　　　　ATLTRACE2 (atlTraceUI,　0,　_T("CUpdateUIObject　and　RemoveUpdateUI　are　deprecated.　Please　 change　your　code　to　use　CIdleHandler　and　OnIdle\n"));
　　　　　　　　 return　RemoveIdleHandler(pIdleHandler);
　　　　}
#endif　//　! _ATL_NO_OLD_NAMES

//　message　loop
　　　　int　Run()
　　　　{
　　　　　　　　BOOL　bDoIdle　=　TRUE;
　　　　　　　　int　nIdleCount　=　0;
　 　　　　　　　BOOL　bRet;

　　　　　　　　for(;;)
　　　　　　　　{
　 　　　　　　　　　　　while(bDoIdle　&&　!::PeekMessage(&m_msg,　NULL,　0,　0, 　PM_NOREMOVE))
　　　　　　　　　　　　{
　　　　　　　　　　　　　　　　if(! OnIdle(nIdleCount++))
　　　　　　　　　　　　　　　　　　　　bDoIdle　=　FALSE;
　　　　　　　　　　　　}

　　　　　　　　　　　　bRet　=　::GetMessage (&m_msg,　NULL,　0,　0);

　　　　　　　　　　　　if(bRet　==　-1)
　　 　　　　　　　　　　{
　　　　　　　　　　　　　　　　ATLTRACE2(atlTraceUI,　0,　_T ("::GetMessage　returned　-1　(error)\n"));
　　　　　　　　　　　　　　　　 continue;　　　//　error,　don't　process
　　　　　　　　　　　　}
　　　　 　　　　　　　　else　if(!bRet)
　　　　　　　　　　　　{
　　　　　　　　　　　 　　　　　ATLTRACE2(atlTraceUI,　0,　_T("CMessageLoop::Run　-　exiting\n"));
　　　　　　　　　　　　　　　　break;　　　//　WM_QUIT,　exit　message　loop
　　　 　　　　　　　　　}

　　　　　　　　　　　　if(!PreTranslateMessage (&m_msg))
　　　　　　　　　　　　{
　　　　　　　　　　　　　　　 　::TranslateMessage(&m_msg);
　　　　　　　　　　　　　　　　::DispatchMessage (&m_msg);
　　　　　　　　　　　　}

　　　　　　　　　　　　if (IsIdleMessage(&m_msg))
　　　　　　　　　　　　{
　　　　　　　　　　　　　 　　　bDoIdle　=　TRUE;
　　　　　　　　　　　　　　　　nIdleCount　=　0;
　　　 　　　　　　　　　}
　　　　　　　　}

　　　　　　　　return　(int) m_msg.wParam;
　　　　}

　　　　static　BOOL　IsIdleMessage(MSG*　pMsg)
　　　　{
　　　　　　　　//　These　messages　should　NOT　cause　idle　 processing
　　　　　　　　switch(pMsg->message)
　　　　　　　　{
　　　 　　　　　case　WM_MOUSEMOVE:
#ifndef　_WIN32_WCE
　　　　　　　　case　 WM_NCMOUSEMOVE:
#endif　//　!_WIN32_WCE
　　　　　　　　case　WM_PAINT:
　　 　　　　　　case　0x0118:　　　　//　WM_SYSTIMER　(caret　blink)
　　　　　　　　　　 　　return　FALSE;
　　　　　　　　}

　　　　　　　　return　TRUE;
　 　　　}

//　Overrideables
　　　　//　Override　to　change　message　 filtering
　　　　virtual　BOOL　PreTranslateMessage(MSG*　pMsg)
　　　　{
　　　　　　　　//　loop　backwards
　　　　　　　　for(int　i　=　 m_aMsgFilter.GetSize()　-　1;　i　>=　0;　i--)
　　　　　　　　{
　　　　　　 　　　　　　CMessageFilter*　pMessageFilter　=　m_aMsgFilter[i];
　　　　　　　　　　 　　if(pMessageFilter　!=　NULL　&&　pMessageFilter->PreTranslateMessage(pMsg))
　　　　　　　　　　　　　　　　return　TRUE;
　　　　　　　　}
　　　　　 　　　return　FALSE;　　　//　not　translated
　　　　}

　　　　//　 override　to　change　idle　processing
　　　　virtual　BOOL　OnIdle(int 　/*nIdleCount*/)
　　　　{
　　　　　　　　for(int　i　=　0;　i　<　 m_aIdleHandler.GetSize();　i++)
　　　　　　　　{
　　　　　　　　　　　　 CIdleHandler*　pIdleHandler　=　m_aIdleHandler[i];
　　　　　　　　　　　　if (pIdleHandler　!=　NULL)
　　　　　　　　　　　　　　　　pIdleHandler->OnIdle();
　　　　　　　　}
　　　　　　　　return　FALSE;　　　//　don't　continue
　　　　}
};