【Qt之事件过滤器】使用

news2025/10/31 11:02:47

介绍

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

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

事件产生阶段：事件的产生通常是由用户操作引起的，例如点击鼠标、按下键盘等。
事件分发阶段：在此阶段，事件被发送到目标对象，目标对象可以是一个窗口、一个控件或任何QObject的子类实例。
事件过滤阶段：在此阶段，事件可以被一个或多个事件过滤器所拦截。如果事件被拦截，它将不再被分发到目标对象。
事件处理阶段：在此阶段，目标对象接收到事件并执行相应的处理代码。如果对象没有处理事件，它会将事件发送给它的父对象，直到事件被处理或到达应用程序的顶级对象。
事件传播阶段：在此阶段，事件可能会被传递给其他对象，例如父对象、兄弟对象或应用程序的全局事件过滤器。
事件回溯阶段：在此阶段，如果事件没有被处理，它会向事件的产生者传递一个未处理的事件通知。

在事件处理的整个过程中，事件对象都是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()函数，启动应用程序。