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