Qt 事件處理機制（下篇）

作者：佚名 2011-07-01 14:20:59

在Qt中，事件被封裝成一個個對象，所有的事件均繼承自抽象類QEvent. 接下來依次談談Qt中有誰來產生、分發、接受和處理事件。

繼續我們上一篇文章繼續介紹，Qt 事件處理機制（上篇）介紹了Qt框架的事件處理機制：事件的產生、分發、接受和處理，并以視窗系統鼠標點擊QWidget為例，對代碼進行了剖析，向大家分析了Qt框架如何通過Event Loop處理進入處理消息隊列循環，如何一步一步委派給平臺相關的函數獲取、打包用戶輸入事件交給視窗系統處理，函數調用棧如下：

main(int, char **)   
QApplication::exec()   
QCoreApplication::exec()   
QEventLoop::exec(ProcessEventsFlags )   
QEventLoop::processEvents(ProcessEventsFlags )   
QEventDispatcherWin32::processEvents(QEventLoop::ProcessEventsFlags)

本文將介紹Qt app在視窗系統回調后，事件又是怎么一步步通過QApplication分發給最終事件的接受和處理者QWidget::event, （QWidget繼承Object,重載其虛函數event)，以下所有的討論都將嵌入在源碼之中。

QT_WIN_CALLBACK QtWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam) bool QETWidget::translateMouseEvent(const MSG &msg)   
bool QApplicationPrivate::sendMouseEvent(...)   
inline bool QCoreApplication::sendSpontaneousEvent(QObject *receiver, QEvent *event)   
bool QCoreApplication::notifyInternal(QObject *receiver, QEvent *event)   
bool QApplication::notify(QObject *receiver, QEvent *e)   
bool QApplicationPrivate::notify_helper(QObject *receiver, QEvent * e)   
bool QWidget::event(QEvent *event)   
 
// (續上文Section 7) Section 2-1：     
QT_WIN_CALLBACK QtWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)      
{     
   ...     
   //檢查message是否屬于Qt可轉義的鼠標事件     
   if (qt_is_translatable_mouse_event(message)) {     
        if (QApplication::activePopupWidget() != 0) {                 
            POINT curPos = msg.pt;     
            //取得鼠標點擊坐標所在的QWidget指針，它指向我們在main創建的widget實例     
            QWidget* w = QApplication::widgetAt(curPos.x, curPos.y);     
            if (w)     
                widget = (QETWidget*)w;     
        }     
        if (!qt_tabletChokeMouse) {     
            //對，就在這里。Windows的回調函數將鼠標事件分發回給了Qt Widget      
            // => Section 2-2     
            result = widget->translateMouseEvent(msg);            
     ...     
}     
// Section 2-2  $QTDIR\src\gui\kernel\qapplication_win.cpp     
//該函數所在與Windows平臺相關，主要職責就是把已windows格式打包的鼠標事件解包、翻譯成QApplication可識別的QMouseEvent,QWidget.     
bool QETWidget::translateMouseEvent(const MSG &msg)     
{     
     //.. 這里很長的代碼給以忽略       
      // 讓我們看一下sendMouseEvent的聲明     
     // widget是事件的接受者； e是封裝好的QMouseEvent     
     // ==> Section 2-3     
     res = QApplicationPrivate::sendMouseEvent(widget, &e, alienWidget, this, &qt_button_down, qt_last_mouse_receiver);     
}     
// Section 2-3 $QTDIR\src\gui\kernel\qapplication.cpp     
bool QApplicationPrivate::sendMouseEvent(QWidget *receiver, QMouseEvent *event,     
                                         QWidget *alienWidget, QWidget *nativeWidget,     
                                         QWidget **buttonDown, QPointer<QWidget> &lastMouseReceiver,     
                                         bool spontaneous)     
{     
     //至此與平臺相關代碼處理完畢     
     //MouseEvent默認的發送方式是spontaneous, 所以將執行sendSpontaneousEvent。 sendSpontaneousEvent() 與 sendEvent的代碼實現幾乎相同，
                   除了將QEvent的屬性spontaneous標記不同。 這里是解釋什么spontaneous事件：如果事件由應用程序之外產生的，比如一個系統事件。 
               顯然MousePress事件是由視窗系統產生的一個的事件（詳見上文Section 1~ Section 7),因此它是   spontaneous事件     
       
    if (spontaneous)     
        result = QApplication::sendSpontaneousEvent(receiver, event);  ==〉Section 2-4     
    else    
        result = QApplication::sendEvent(receiver, event);     
}    
// (續上文Section 7) Section 2-1：  
QT_WIN_CALLBACK QtWndProc(HWND hwnd, UINT message, WPARAM wParam, LPARAM lParam)   
{  
   ...  
   //檢查message是否屬于Qt可轉義的鼠標事件  
   if (qt_is_translatable_mouse_event(message)) {  
        if (QApplication::activePopupWidget() != 0) {              
            POINT curPos = msg.pt;  
            //取得鼠標點擊坐標所在的QWidget指針，它指向我們在main創建的widget實例  
            QWidget* w = QApplication::widgetAt(curPos.x, curPos.y);  
            if (w)  
                widget = (QETWidget*)w;  
        }  
        if (!qt_tabletChokeMouse) {  
            //對，就在這里。Windows的回調函數將鼠標事件分發回給了Qt Widget   
            // => Section 2-2  
            result = widget->translateMouseEvent(msg);         
     ...  
}  
// Section 2-2  $QTDIR\src\gui\kernel\qapplication_win.cpp  
//該函數所在與Windows平臺相關，主要職責就是把已windows格式打包的鼠標事件解包、翻譯成QApplication可識別的QMouseEvent,QWidget.  
bool QETWidget::translateMouseEvent(const MSG &msg)  
{  
     //.. 這里很長的代碼給以忽略    
      // 讓我們看一下sendMouseEvent的聲明  
     // widget是事件的接受者； e是封裝好的QMouseEvent  
     // ==> Section 2-3  
     res = QApplicationPrivate::sendMouseEvent(widget, &e, alienWidget, this, &qt_button_down, qt_last_mouse_receiver);  
}  
// Section 2-3 $QTDIR\src\gui\kernel\qapplication.cpp  
bool QApplicationPrivate::sendMouseEvent(QWidget *receiver, QMouseEvent *event,  
                                         QWidget *alienWidget, QWidget *nativeWidget,  
                                         QWidget **buttonDown, QPointer<QWidget> &lastMouseReceiver,  
                                         bool spontaneous)  
{  
     //至此與平臺相關代碼處理完畢  
     //MouseEvent默認的發送方式是spontaneous, 所以將執行sendSpontaneousEvent。 sendSpontaneousEvent() 與 sendEvent的代碼實現幾乎相同，
                        除了將QEvent的屬性spontaneous標記不同。 這里是解釋什么spontaneous事件：如果事件由應用程序之外產生的，比如一個系統事件。 
                     顯然MousePress事件是由視窗系統產生的一個的事件（詳見上文Section 1~ Section 7),因此它是spontaneous事件  
    if (spontaneous)  
        result = QApplication::sendSpontaneousEvent(receiver, event);  ==〉Section 2-4  
    else  
        result = QApplication::sendEvent(receiver, event);  
}

// Section 2-4 C:\Qt\4.7.1-Vs\src\corelib\kernel\qcoreapplication.h     
inline bool QCoreApplication::sendSpontaneousEvent(QObject *receiver, QEvent *event)     
{      
    //將event標記為自發事件     
     //進一步調用 2-5 QCoreApplication::notifyInternal     
    if (event) event->spont = true; return self ? self->notifyInternal(receiver, event) : false;      
}     
// Section 2-5:  $QTDIR\gui\kernel\qapplication.cpp     
bool QCoreApplication::notifyInternal(QObject *receiver, QEvent *event)     
{     
         
    // 幾行代碼對于Qt Jambi (QT Java綁定版本） 和QSA (QT Script for Application)的支持     
     ...     
     // 以下代碼主要意圖為Qt強制事件只能夠發送給當前線程里的對象，也就是說receiver->d_func()->threadData應該等于QThreadData::current()。
                                          注意，跨線程的事件需要借助Event Loop來派發     
     QObjectPrivate *d = receiver->d_func();     
    QThreadData *threadData = d->threadData;     
    ++threadData->loopLevel;     
    bool returnValue;     
    QT_TRY {     
        //哇，終于來到大名鼎鼎的函數QCoreApplication::nofity()了 ==> Section 2-6     
        returnValue = notify(receiver, event);     
    } QT_CATCH (...) {     
        --threadData->loopLevel;     
        QT_RETHROW;     
    }     
}     
// Section 2-6:  $QTDIR\gui\kernel\qapplication.cpp     
// QCoreApplication::notify和它的重載函數QApplication::notify在Qt的派發過程中起到核心的作用，Qt的官方文檔時這樣說的：
                                                       任何線程的任何對象的所有事件在發送時都會調用notify函數。     
bool QApplication::notify(QObject *receiver, QEvent *e)     
{     
   //代碼很長，最主要的是一個大大的Switch,Case     
   ..     
   switch ( e->type())     
   {     
    ...     
    case QEvent::MouseButtonPress:     
    case QEvent::MouseButtonRelease:     
    case QEvent::MouseButtonDblClick:     
    case QEvent::MouseMove:     
     ...     
        //讓自己私有類(d是私有類的句柄）來進一步處理 ==> Section 2-7     
        res = d->notify_helper(w, w == receiver ? mouse : &me);     
        e->spont = false;     
        break;     
    }     
    ...     
}     
// Section 2-7:  $QTDIR\gui\kernel\qapplication.cpp     
bool QApplicationPrivate::notify_helper(QObject *receiver, QEvent * e)     
{     
    ...     
    // 向事件過濾器發送該事件，這里介紹一下Event Filters. 事件過濾器是一個接受即將發送給目標對象所有事件的對象。     
   //如代碼所示它開始處理事件在目標對象行動之前。過濾器的QObject::eventFilter（）實現被調用，能接受或者丟棄過濾，
                         允許或者拒絕事件的更進一步的處理。如果所有的事件過濾器允許更進一步的事件處理，事件將被發送到目標對象本身。
                         如果他們中的一個停止處理，目標和任何后來的事件過濾器不能看到任何事件。     
    if (sendThroughObjectEventFilters(receiver, e))     
        return true;     
     // 遞交事件給receiver  => Section 2-8     
    bool consumed = receiver->event(e);     
    e->spont = false;     
}     
// Section 2-8  $QTDIR\gui\kernel\qwidget.cpp     
// QApplication通過notify及其私有類notify_helper,將事件最終派發給了QObject的子類- QWidget.     
bool QWidget::event(QEvent *event)     
{     
    ...     
    switch(event->type()) {     
    case QEvent::MouseButtonPress:     
        // Don't reset input context here. Whether reset or not is     
        // a responsibility of input method. reset() will be     
        // called by mouseHandler() of input method if necessary     
        // via mousePressEvent() of text widgets.     
#if 0     
        resetInputContext();     
#endif     
        //mousePressEvent是虛函數，QWidget的子類可以通過重載重新定義mousePress事件的行為     
        mousePressEvent((QMouseEvent*)event);     
        break;        
}

小結：Qt 事件處理機制（下篇）的內容介紹完了，希望本文對你有所幫助！更多相關資料請參考編輯推薦！

責任編輯：zhaolei 來源：互聯網

Qt 事件

Qt 事件處理機制 （下篇）

Qt 事件處理機制（下篇）