【Qt之事件过滤器】使用

介绍

事件过滤器是Qt中一种重要的机制，用于拦截并处理窗口和其他对象的事件。
它可以在不修改已有代码的情况下，动态地增加、删除一些处理事件的代码，并能够对特定对象的事件进行拦截和处理。

在Qt中，事件处理经过以下几个阶段：

1. 事件产生阶段：事件的产生通常是由用户操作引起的，例如点击鼠标、按下键盘等。

2. 事件分发阶段：在此阶段，事件被发送到目标对象，目标对象可以是一个窗口、一个控件或任何QObject的子类实例。

3. 事件过滤阶段：在此阶段，事件可以被一个或多个事件过滤器所拦截。如果事件被拦截，它将不再被分发到目标对象。

4. 事件处理阶段：在此阶段，目标对象接收到事件并执行相应的处理代码。如果对象没有处理事件，它会将事件发送给它的父对象，直到事件被处理或到达应用程序的顶级对象。

5. 事件传播阶段：在此阶段，事件可能会被传递给其他对象，例如父对象、兄弟对象或应用程序的全局事件过滤器。

6. 事件回溯阶段：在此阶段，如果事件没有被处理，它会向事件的产生者传递一个未处理的事件通知。

在事件处理的整个过程中，事件对象都是QEvent的子类实例，不同的事件类型对应着不同的处理流程和方法。

事件过滤器通常由两个部分组成，一个是事件过滤器类，另一个是需要进行事件过滤的对象。

示例

.h

class MyEventFilter : public QObject
{
    Q_OBJECT
public:
    explicit MyEventFilter(QObject* parent = nullptr) : QObject(parent){}

protected:
    bool eventFilter(QObject* obj, QEvent* event) override
    {
        if (event->type() == QEvent::MouseButtonPress)
        {
            qDebug().noquote() << "[" << __FILE__ << __LINE__ << "]" << "Mouse press event intercepted by event filter";
            return true;
        }
        return QObject::eventFilter(obj, event);
    }
};

cpp

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    QPushButton button("Click me");
    MyEventFilter eventFilter;
    button.installEventFilter(&eventFilter);
    button.show();

    return a.exec();
}

结果

在示例中，

• 创建了一个MyEventFilter类，继承自QObject类，并重写了它的eventFilter()函数。
• 在该函数中，判断拦截的事件类型是否为鼠标按下事件，如果是，就输出一条调试信息，并返回true，表示事件被过滤掉了。如果是其他类型的事件，则将其交给原来的eventFilter()函数进行处理。
• 创建了一个QPushButton对象，并通过installEventFilter()函数设置了事件过滤器为eventFilter对象，即button对象的事件会先经过eventFilter对象的处理，再由button对象处理。
• 调用QApplication的exec()函数，启动应用程序。

使用场景

1. 拦截某个对象的事件：当需要对某个控件的某个事件进行特殊处理时，可以使用事件过滤器来实现。

2. 监听全局事件：通过将事件过滤器对象安装到QApplication中，可以监控所有窗口和控件的事件。

3. 监听事件流：通过事件过滤器，可以拦截并记录事件流，以便在需要时进行调试和分析。