qt 系统 - 事件分发器 and 事件过滤器
一、事件分发器
1. 事件分发器概念
在 Qt 中，事件分发器(Event Dispatcher) 是一个核心概念，用于处理 GUI 应用程序中的事件。事件分发器负责将事件从⼀个对象传递到另⼀个对象，直到事件被处理或被取消。每个继承自 QObject 类或 QObject 类本身都可以在本类中重写 bool event(QEvent *e) 函数，来实现相关事件的捕获和拦截。
2. 事件分发器工作原理
在 Qt 中，我们发送的事件都是传给了 QObject 对象，更具体点是传给了 QObject 对象的 event() 函数。所有的事件都会进入到这个函数里面，那么我们处理事件就要重写这个 event() 函数。event() 函数本⾝不会去处理事件，而是根据 事件类型（type值）调用不同的事件处理函数。事件分发器就是工
作在应用程序向下分发事件的过程中，如下图：
如上图，事件分发器⽤于分发事件。在此过程中，事件分发器也可以做拦截操作。事件分发器主要是通过 bool event(QEvent *e) 函数来实现。其返回值为布尔类型，若为 ture，代表拦截，不向下分发。
Qt 中的事件是封装在 QEvent 类中，在 Qt 助手中输入 QEvent 可以查看其所包括的事件类型，如下图示：
示例代码：
1、在 “widget.h” 头⽂件中声明 ⿏标点击事件 和 事件分发器；如下图⽰：
class Widget : public QWidget
{
Q_OBJECT
public:
Widget(QWidget *parent = nullptr);
~Widget();
// 鼠标点击事件
void mousePressEvent(QMouseEvent* event);
// 通过事件分发器拦截鼠标按下事件
bool event(QEvent* event);
private:
Ui::Widget *ui;
};
2、在 “widget.cpp” ⽂件中实现 ⿏标点击事件 和 拦截事件；
#include <QDebug>
#include <QMouseEvent>
void Widget::mousePressEvent(QMouseEvent *event)
{
if(event->button() == Qt::LeftButton) {
qDebug() << "鼠标左键被按下！";
}
}
bool Widget::event(QEvent *event)
{
if(event->type() == QEvent::MouseButtonPress) {
qDebug() << "Event 中鼠标被按下！";
return true; // return true 代表不向下分发
}
// 其它事件交给父类处理（默认处理）
return false;
}
执行效果如下，当鼠标左键点击窗口时，就会执行 event 函数，而不会执行 mousePressEvent 函数：
二、事件过滤器
在 Qt 中，⼀个对象可能经常要查看或拦截另外⼀个对象的事件，如对话框想要拦截按键事件，不让别的组件接收到，或者修改按键的默认值等。通过上面的学习，我们已经知道，Qt 创建了 QEvent 事件对象之后，会调用 QObject 的 event() 函数处理事件的分发。显然，我们可以在 event() 函数 中实现拦
截的操作。由于 event() 函数是 protected 的，因此，需要继承已有类。如果组件很多，就需要重写很多个 event() 函数。这当然相当麻烦，更不用说重写 event() 函数还得小心一堆问题。好在 Qt 提供了另外⼀种机制来达到这一目的：事件过滤器。
事件过滤器是在应用程序分发到 event 事件分发器之前，再做⼀次更高级的拦截。如下图示：
事件过滤器的⼀般使用步骤：
- 安装事件过滤器；
- 重写事件过滤器函数：eventfilter()
代码示例：
1、设计 UI 文件，拖入一个 label，如下图示；
3、在项目新添加⼀个类：MyLabel；
先选中项目名称 QEvent_2，点击⿏标右键，选择 add new … ，弹出如下对话框，选择 Choose 即可：
4、选择：Choose … 后，弹出如下界面，按照如下形式创建即可：
5、此时项目中会新添加我们刚新建的头文件和cpp文件；
6、在 UI 文件中选中 Label，右键 ------> 提升为…；当点击 "提升为… " 之后，弹出如下对话框：
接下来按照下图选择即可：
7、在 “mylabel.h” 中声明 ⿏标点击事件 和 事件分发器：
#include <QWidget>
#include <QLabel>
class myLabel : public QLabel
{
Q_OBJECT
public:
explicit myLabel(QWidget *parent = nullptr);
// 鼠标点击事件
void mousePressEvent(QMouseEvent* event);
// 事件分发器
bool event(QEvent* e);
};
8、在 “mylabel.cpp” ⽂件中实现⿏标点击事件和事件分发器；
#include <QMouseEvent>
#include <QDebug>
myLabel::myLabel(QWidget *parent) : QLabel(parent)
{}
void myLabel::mousePressEvent(QMouseEvent *event)
{
QString str = QString("鼠标按下: x = %1, y = %2").arg(event->x()).arg(event->y());
qDebug() << str.toUtf8().data();
}
bool myLabel::event(QEvent *e)
{
// 如果是鼠标按下，在event事件分发时拦截操作
if(e->type() == QEvent::MouseButtonPress) {
QMouseEvent* event = static_cast<QMouseEvent*>(e);
QString str = QString("Event 函数中鼠标按下: x = %1, y = %2").arg(event->x()).arg(event->y());
qDebug() << str.toUtf8().data();
return true; // 返回true，代表用户自己处理，不向下分发
}
return QLabel::event(e); // 其他事件交给父类处理
}
9、在 “widget.h” 头文件中声明事件过滤器函数；
class Widget : public QWidget
{
Q_OBJECT
public:
Widget(QWidget *parent = nullptr);
~Widget();
// 声明 eventfilter 事件
bool eventFilter(QObject* obj, QEvent* e);
private:
Ui::Widget *ui;
};
10、在 “widget.cpp” ⽂件中实现事件过滤器的两个步骤；
#include <QEvent>
#include <QMouseEvent>
#include <QDebug>
Widget::Widget(QWidget *parent)
: QWidget(parent)
, ui(new Ui::Widget)
{
ui->setupUi(this);
// 1. 给label安装事件过滤器，this：当前窗口安装事件过滤器
ui->label->installEventFilter(this);
}
// 2. 重写eventfilter事件
bool Widget::eventFilter(QObject *obj, QEvent *e)
{
// 判断控件
if(obj == ui->label) {
if(e->type() == QEvent::MouseButtonPress) {
QMouseEvent* event = static_cast<QMouseEvent*>(e);
QString str = QString("事件过滤器中鼠标按下：x = %1, y = %2").arg(event->x()).arg(event->y());
qDebug() << str.toUtf8().data();
return true;
}
}
// 其它交给父类处理
return QWidget::eventFilter(obj, e);
}
执行效果如下，当在标签中点击鼠标时不会执行 event 函数，而会执行 eventfilter 函数：
