Qt 事件過(guò)濾器

事件過(guò)濾器

Qt 創(chuàng)建了 QEvent 事件對(duì)象之后，會(huì)調(diào)用 QObject 的 event()函數(shù)做事件的分發(fā)。有時(shí)候，你可能需要在調(diào)用 event()函數(shù)之前做一些另外的操作，比如，對(duì)話框上某些組件可能并不需要響應(yīng)回車按下的事件，此時(shí)，你就需要重新定義組件的 event()函數(shù)。如果組件很多，就需要重寫很多次 event()函數(shù)，這顯然沒有效率。為此，你可以使用一個(gè)事件過(guò)濾器，來(lái)判斷是否需要調(diào)用 event()函數(shù)。

QOjbect 有一個(gè) eventFilter()函數(shù)，用于建立事件過(guò)濾器。這個(gè)函數(shù)的簽名如下：

virtual bool QObject::eventFilter ( QObject * watched, QEvent * event )

如果 watched 對(duì)象安裝了事件過(guò)濾器，這個(gè)函數(shù)會(huì)被調(diào)用并進(jìn)行事件過(guò)濾，然后才輪到組件進(jìn)行事件處理。在重寫這個(gè)函數(shù)時(shí)，如果你需要過(guò)濾掉某個(gè)事件，例如停止對(duì)這個(gè)事件的響應(yīng)，需要返回 true。

bool MainWindow::eventFilter(QObject *obj, QEvent *event)
 {
         if (obj == textEdit) {
                 if (event->type() == QEvent::KeyPress) {
                         QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
                         qDebug() << "Ate key press" << keyEvent->key();
                         return true;
                 } else {
                         return false;
                 }
         } else {
                 // pass the event on to the parent class
                 return QMainWindow::eventFilter(obj, event);
         }
 }

上面的例子中為 MainWindow 建立了一個(gè)事件過(guò)濾器。為了過(guò)濾某個(gè)組件上的事件，首先需要判斷這個(gè)對(duì)象是哪個(gè)組件，然后判斷這個(gè)事件的類型。例如，我不想讓 textEdit 組件處理鍵盤事件，于是就首先找到這個(gè)組件，如果這個(gè)事件是鍵盤事件，則直接返回 true，也就是過(guò)濾掉了這個(gè)事件，其他事件還是要繼續(xù)處理，所以返回 false。對(duì)于其他組件，我們并不保證是不是還有過(guò)濾器，于是最保險(xiǎn)的辦法是調(diào)用父類的函數(shù)。

在創(chuàng)建了過(guò)濾器之后，下面要做的是安裝這個(gè)過(guò)濾器。安裝過(guò)濾器需要調(diào)用 installEventFilter()函數(shù)。這個(gè)函數(shù)的簽名如下：

void QObject::installEventFilter ( QObject * filterObj )

這個(gè)函數(shù)是 QObject 的一個(gè)函數(shù)，因此可以安裝到任何 QObject 的子類，并不僅僅是 UI 組件。這個(gè)函數(shù)接收一個(gè) QObject 對(duì)象，調(diào)用了這個(gè)函數(shù)安裝事件過(guò)濾器的組件會(huì)調(diào)用 filterObj 定義的eventFilter()函數(shù)。例如，textField.installEventFilter(obj)，則如果有事件發(fā)送到textField 組件是，會(huì)先調(diào)用 obj->eventFilter()函數(shù)，然后才會(huì)調(diào)用 textField.event()。

當(dāng)然，你也可以把事件過(guò)濾器安裝到 QApplication 上面，這樣就可以過(guò)濾所有的事件，已獲得更大的控制權(quán)。不過(guò)，這樣做的后果就是會(huì)降低事件分發(fā)的效率。

如果一個(gè)組件安裝了多個(gè)過(guò)濾器，則最后一個(gè)安裝的會(huì)最先調(diào)用，類似于堆棧的行為。

注意，如果你在事件過(guò)濾器中 delete 了某個(gè)接收組件，務(wù)必將返回值設(shè)為 true。否則，Qt 還是會(huì)將事件分發(fā)給這個(gè)接收組件，從而導(dǎo)致程序崩潰。

事件過(guò)濾器和被安裝的組件必須在同一線程，否則，過(guò)濾器不起作用。另外，如果在 install 之后，這兩個(gè)組件到了不同的線程，那么，只有等到二者重新回到同一線程的時(shí)候過(guò)濾器才會(huì)有效。

事件的調(diào)用最終都會(huì)調(diào)用 QCoreApplication 的 notify()函數(shù)，因此，最大的控制權(quán)實(shí)際上是重寫QCoreApplication 的 notify()函數(shù)。由此可以看出，Qt 的事件處理實(shí)際上是分層五個(gè)層次：重定義事件處理函數(shù)，重定義 event()函數(shù)，為單個(gè)組件安裝事件過(guò)濾器，為 QApplication 安裝事件過(guò)濾器，重定義 QCoreApplication 的 notify()函數(shù)。這幾個(gè)層次的控制權(quán)是逐層增大的。

本文出自 “豆子空間” 博客，請(qǐng)務(wù)必保留此出處 http://devbean.blog.51cto.com/448512/194031