当我们非常熟练得用着MFC/ATL/WTL的时候,是否还记得如何用SDK方式编写程序?本博客将关注与用MFC/ATL/WTL时容易忽略的问题,容易犯的错误,以及一些技巧。

作为第一篇,我们先来讨论一下最基础的一个东西,消息循环(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, 00 )) != 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, 00 )) != 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, 00, PM_NOREMOVE))
                {
                    
    if(!OnIdle(nIdleCount++))
                        bDoIdle 
    = FALSE;
                }

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

                
    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
        }
    };

    相关文章: