Qt学习之路(22): 事件过滤器

Qt建立了QEvent事件对象以后，会调用QObject的event()函数作事件的分发。有时候，你可能须要在调用event()函数以前作一些另外的操做，好比，对话框上某些组件可能并不须要响应回车按下的事件，此时，你就须要从新定义组件的event()函数。若是组件不少，就须要重写不少次event()函数，这显然没有效率。为此，你可使用一个事件过滤器，来判断是否须要调用event()函数。

QOjbect有一个eventFilter()函数，用于创建事件过滤器。这个函数的签名以下：

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

若是watched对象安装了事件过滤器，这个函数会被调用并进行事件过滤，而后才轮到组件进行事件处理。在重写这个函数时，若是你须要过滤掉某个事件，例如中止对这个事件的响应，须要返回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创建了一个事件过滤器。为了过滤某个组件上的事件，首先须要判断这个对象是哪一个组件，而后判断这个事件的类型。例如，我不想让textEdit组件处理键盘事件，因而就首先找到这个组件，若是这个事件是键盘事件，则直接返回true，也就是过滤掉了这个事件，其余事件仍是要继续处理，因此返回false。对于其余组件，咱们并不保证是否是还有过滤器，因而最保险的办法是调用父类的函数。

在建立了过滤器以后，下面要作的是安装这个过滤器。安装过滤器须要调用installEventFilter()函数。这个函数的签名以下：

void QObject::installEventFilter ( QObject * filterObj )

这个函数是QObject的一个函数，所以能够安装到任何QObject的子类，并不只仅是UI组件。这个函数接收一个QObject对象，调用了这个函数安装事件过滤器的组件会调用filterObj定义的eventFilter()函数。例如，textField.installEventFilter(obj)，则若是有事件发送到textField组件是，会先调用obj->eventFilter()函数，而后才会调用textField.event()。

固然，你也能够把事件过滤器安装到QApplication上面，这样就能够过滤全部的事件，已得到更大的控制权。不过，这样作的后果就是会下降事件分发的效率。

若是一个组件安装了多个过滤器，则最后一个安装的会最早调用，相似于堆栈的行为。

注意，若是你在事件过滤器中delete了某个接收组件，务必将返回值设为true。不然，Qt仍是会将事件分发给这个接收组件，从而致使程序崩溃。 事件过滤器和被安装的组件必须在同一线程，不然，过滤器不起做用。另外，若是在install以后，这两个组件到了不一样的线程，那么，只有等到两者从新回到同一线程的时候过滤器才会有效。 事件的调用最终都会调用QCoreApplication的notify()函数，所以，最大的控制权其实是重写QCoreApplication的notify()函数。由此能够看出，Qt的事件处理其实是分层五个层次：重定义事件处理函数，重定义event()函数，为单个组件安装事件过滤器，为QApplication安装事件过滤器，重定义QCoreApplication的notify()函数。这几个层次的控制权是逐层增大的。