Qt学习之事件过滤器

有时候我们在自定义事件时,并不是需要所有的事件类型都要触发的,例如在数字键盘中,我们就不希望按下字母可以触发事件并输入到编辑框中。那么Qt可通过事件过滤器机制来过滤掉一部分事件。

概述

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

在Qt中,当一个事件发生时(例如鼠标点击或某个键盘上的按键按下),其传递顺序如下所示。事件过滤器首先获得事件,其次才是部件的 event 函数,最后是部件的事件处理函数。

例如:事件过滤器–>部件的event函数–>部件的事件处理函数

事件过滤器和组件等之间的关系图

事件过滤器函数声明与定义

事件过滤器由QObject类中的两个函数来实现
第一个函数是 eventFilter 函数,此函数用于建立事件过滤器。
这个函数的声明如下:

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

请注意:
1)该函数在 QObject 类中声明为一个虚函数,因此只能由 QObject 的子类继承使用
2)该函数在 QObject 类中是一个保护成员,因此子类继承时不可以作为一个公有成员

另一个是 installEventFilter函数,它负责在相应部件上安装事件过滤器,其声明为:

void QObject::installEventFilter(QObject *filterObj);

其中,filterObj参数表示要在其上实现事件过滤器函数的部件。
请注意,如果我们在一个部件安装了事件过滤器,一般在其父控件上实现事件过滤器函数。

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

例如,安装事件过滤器后textEdit.installEventFilter(obj),如果有事件发送到textEdit组件是,会先调用obj->eventFilter()函数,然后才会调用textEdit.event()。

事件过滤器案例说明

事件过滤器它会检查接收到的事件,如果这个事件是我们感兴趣的类型,就进行我们自己的处理;如果不是,就继续转发。这个函数返回一个 bool 类型,如果你想将参数 event 过滤出来。比如,不想让它继续转发,就返回 true,否则返回 false。事件过滤器的调用时间是目标对象(也就是参数里面的watched对象)接收到事件对象之前。也就是说,如果你在事件过滤器中停止了某个事件,那么,watched对象以及以后所有的事件过滤器根本不会知道这么一个事件

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

bool MainWindow::eventFilter(QObject *obj, QEvent *event)
 {
         if (obj == textEdit) {                //判断是否为这个组件
                if (event->type() == QEvent::KeyPress) {  //使用了QEvent的type()函数来获取事件的类型
                         QKeyEvent *keyEvent = static_cast<QKeyEvent*>(event);
                         qDebug() << "Ate key press" << keyEvent->key();
                         return true;            //直接返回true,也就是过滤掉这个事件
                 }
                else {
                         return false;          //其他事件还是要继续处理,所以返回false
                 }
        }
        else {
                 // pass the event on to the parent class
                 return QMainWindow::eventFilter(obj, event);
         }
 }

上面的例子中为MainWindow建立了一个事件过滤器。

为了过滤某个组件上的事件,首先需要判断这个对象是哪个组件,然后判断这个事件的类型。

例如,我不想让textEdit组件处理键盘事件,于是就首先找到这个组件,使用了QEvent的type()函数来获取事件的类型。如果这个事件是键盘事件,则直接返回true,也就是过滤掉了这个事件,其他事件还是要继续处理,所以返回false

对于其他组件,我们并不保证是不是还有过滤器,于是最保险的办法是调用父类的函数。

注意,event()函数和事件处理函数,是在该部件内进行重新定义的,而事件过滤器却是在该部件的父部件中进行定义的

事件过滤器的注意事项

1、你也可以把事件过滤器安装到QApplication上面,这样就可以过滤所有的事件,已获得更大的控制权。不过,这样做的后果就是会降低事件分发的效率。

2、如果一个组件安装了多个过滤器,则最后一个安装的会最先调用,类似于堆栈的行为。

3、注意,如果你在事件过滤器中delete了某个接收组件,务必将返回值设为true。否则,Qt还是会将事件分发给这个接收组件,从而导致程序崩溃。

4、事件过滤器和被安装的组件必须在同一线程,否则,过滤器不起作用。另外,如果在install之后,这两个组件到了不同的线程,那么,只有等到二者重新回到同一线程的时候过滤器才会有效。

解释:事件过滤器和安装过滤器的组件必须在同一线程。Qt 里面,对象创建之后,可以使用 moveToThread() 函数将一个对象移动到另外的线程。在这种情形下(当然,事件过滤器必须在同一线程时才能被正确安装,这是第一句话说明的),在它们分属在不同线程时,事件过滤器也是不起作用的,只用当它们重新回到同一线程(使用 moveToThread() 或者是线程自然结束)时,过滤器才能重新工作

5、事件的调用最终都会调用QCoreApplication的notify()函数,因此,最大的控制权实际上是重写QCoreApplication的notify()函数。由此可以看出,Qt的事件处理实际上是分层五个层次:重定义事件处理函数,重定义event()函数,为单个组件安装事件过滤器,为QApplication安装事件过滤器,重定义QCoreApplication的notify()函数。这几个层次的控制权是逐层增大的

本文福利,费领取Qt开发学习资料包、技术视频,内容包括(Qt实战项目视频教程+代码,C++语言基础,C++设计模式,Qt编程入门,QT信号与槽机制,QT界面开发-图像绘制,QT网络,QT数据库编程,QT项目实战,QSS,OpenCV,Quick模块,面试题等等)↓↓↓↓↓↓见下面↓↓文章底部点击费领取↓↓

猜你喜欢

转载自blog.csdn.net/hw5230/article/details/134752773