QT之GUI学习笔记(十七)---事件过滤器

原文地址:*http://devbean.blog.51cto.com/448512/231861

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

---

一. 概念

1.事件过滤器的作用
提高效率，用于在有很多个组件的情况下判断某个组件对应的事件，是否需要调用event函数。
2.
eventFilter()函数，用于建立事件过滤器。
这个函数的签名如下

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

如果watched对象安装了事件过滤器，这个函数会被调用并进行事件过滤，然后才轮到组件进行事件处理。在重写这个函数时，如果你需要过滤掉某个事件，例如停止对这个事件的响应，需要返回true。

二 代码

1.创建过滤器
(1)代码

//创建过滤器，watched对象为QObject类型
bool MainWindow::eventFilter(QObject *obj, QEvent *event)
 {
         //如果对象为textEdit(文本编辑器)
         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;
                 }
         } 
         //如果对象不是textEditor,那么将事件传递给父对象，让父对象的过滤器进行处理
         else {
                 // pass the event on to the parent class
                 return QMainWindow::eventFilter(obj, event);
         }
 }

(2)
上述代码为MainWindow建立了一个事件过滤器。
为了过滤某个组件上的事件，首先需要判断这个对象是哪个组件，然后判断这个事件的类型。
例如，我不想让textEdit组件处理键盘事件，于是就首先找到这个组件，如果这个事件是键盘事件，则直接返回true，也就是过滤掉了这个事件;其他事件还是要继续处理，所以返回false。对于其他组件，我们并不保证是不是还有过滤器，于是最保险的办法是调用父类的函数。
2.安装过滤器
过滤器的安装需要installEventFilter函数

void QObject::installEventFilter ( QObject * filterObj )

(1)这个函数是QObject的一个函数，因此可以安装到任何QObject的子类。
(2)这个函数接收一个QObject对象，调用了这个函数安装事件过滤器的组件会调用filterObj定义的eventFilter()函数。

三 知识点讲解

1.分析

textField.installEventFilter(obj)

含义是:如果有事件发送到textField组件是，会先调用obj->eventFilter()函数，然后才会调用textField.event()。
2.可以把事件过滤器安装到QApplication上面，这样就可以过滤所有的事件，已获得更大的控制权。不过，这样做的后果就是会降低事件分发的效率。
3.一个组件安装了多个过滤器，则最后一个安装的会最先调用
4.如果你在事件过滤器中delete了某个接收组件，务必将返回值设为true。否则，Qt还是会将事件分发给这个接收组件，从而导致程序崩溃。
5.事件过滤器和被安装的组件必须在同一线程，否则，过滤器不起作用。另外，如果在install之后，这两个组件到了不同的线程，那么，只有等到二者重新回到同一线程的时候过滤器才会有效。
6.事件的调用最终都会调用QCoreApplication的notify()函数，因此，最大的控制权实际上是重写QCoreApplication的notify()函数。由此可以看出，Qt的事件处理实际上是分层五个层次：重定义事件处理函数，重定义event()函数，为单个组件安装事件过滤器，为QApplication安装事件过滤器，重定义QCoreApplication的notify()函数。这几个层次的控制权是逐层增大的。

重定义事件处理函数查看 事件 这一节
重定义event函数 查看 事件接收与忽略这一节
单个组件安装事件过滤器 为这一节所讲的内容