Win32编程之消息循环（Message loop）

Ericky

第一个版本
首先让我们来写一个最容易让人想到的消息循环的形式：
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;
　　　　　　　　　　 　　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;
　　　　　　　　　　　　if (pIdleHandler　!=　NULL)
　　　　　　　　　　　　　　　　pIdleHandler->OnIdle();
　　　　　　　　}
　　　　　　　　return　FALSE;　　　//　don't　continue
　　　　}
}