【VS Code 与 Qt6】运用事件过滤器批量操作子级组件-天天速递

2023-06-11 21:33:47 来源：博客园

如果某个派生自 QObject 的类重写 eventFilter 方法，那它就成了事件过滤器（Event Filter）。该方法的声明如下：

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

watched 参数是监听事件的对象，即事件的接收者；event 参数当然就是待处理的事件了。事件过滤器（也可以翻译为“筛选器”）可在接收者之前拦截事件，处理完毕后还可以决定是否把事件转发给接收者。如果不想转发给事件接收者，就返回 true；若还想让事件继续传播就返回 false。

这玩意儿最有益的用途就是：你的顶层窗口上有 K 个子级组件（正常情形是 QWidget 的子类），如果组件没有定义你想用的信号，只能通过处理事件的途径解决，可你又不想只为了处理一个事件就派生一个类（比如，QLabel组件在鼠标悬浮时做点事情），就可以用上事件过滤器了。顶层窗口类重写 eventFilter 方法，拦截发往子组件的事件（如mouseMove）直接处理，这样能节省 N 百行代码。

(资料图片仅供参考)

重写了 eventFilter 方法的类就成了事件的过滤者，而调用 installEventFilter 方法安装过滤器的类才是事件的原始接收者。就拿上文咱们举的 QLabel 组件的例，假设顶层窗口的类名是 DuckWindow，那么，DuckWindow 重写 eventFilter 方法，它就是事件的拦截者；而 QLabel 组件就是事件的原始接收者，所以，调用 installEventFilter 方法的是它。即 QLabel::installEventFilter( DuckWindow )。

不知道老周这样说大伙伴们能否理解。就是负责过滤事件的对象重写 eventFilter 方法；被别人过滤的对象才调用 installEventFilter 方法。

我们用示例说事。下面咱们要做的练习是这样的：

我定义了一个类叫 MyWindow，继承 QWidget 类，作为顶层窗口。然后在窗口里，我用一个 QHBoxLayout 布局，让窗口内的子级组件水平排列。但每个子组件的颜色不同。常规做法是写个自定义组件类，从构造函数或通过成员函数传一个 QColor 对象过去，然后重写 paintEvent 方法绘图。这种做法肯定没问题的。但是！我要是不想写自定义类呢，那就得考虑事件过滤器了，把 paintEvent 事件过滤，直接用某颜色给子组件画个背景就行了。

头文件声明 MyWindow 类。

#ifndef MYWIN#define MYWIN#include #include #include #include #include #include class MyWindow : public QWidget{    Q_OBJECTpublic:    MyWindow(QWidget* parent=nullptr);    bool eventFilter(QObject *obj, QEvent *event) override;private:    // 私有成员，画痘痘用的    void paintSomething(QPainter *p, const QColor &color, const QRect &paintRect);    // 布局    QHBoxLayout *layout;    // 三个子级组件    QWidget *w1, *w2, *w3;}; #endif

这里提一下这个 eventFilter 方法，这厮声明为 public 和 protected 都是可行的。老周这里就声明为 public，与基类的声明一致。

paintSomething 是私有方法，自定义用来画东西的。有伙伴们会问：QPainter 的 paintDevice 不是可以获取到绘图设置（这里指窗口或组件）的大小的矩形区域吗，为啥要从参数传个 QRect？因为这个 rect 来自 QPaintEvent 对象的事件参数，它指的可不一定窗口/组件的整个矩形区域。如果是局部重绘，这个矩形可能就是其中一小部分区域。所以，咱们用事件传递过来的矩形区域绘图。

窗口布局用的是 QHBoxLayout，非常简单的布局方式，子级组件在窗口上水平排列。

下面代码实现构造函数，初始化各个对象。

MyWindow::MyWindow(QWidget *parent)    : QWidget(parent){    // 初始化    layout = new QHBoxLayout;    this->setLayout(layout);    w1 = new QWidget(this);    w2 = new QWidget(this);    w3 = new QWidget(this);    layout->addWidget(w1);    layout->addWidget(w2);    layout->addWidget(w3);    // 安装事件过滤器    w1->installEventFilter(this);    w2->installEventFilter(this);    w3->installEventFilter(this);}

只有在被拦截的对象上调用 installEventFilter 方法绑定过滤器后，事件过滤器才会生效。此处，由于 MyWindow 类重写了 eventFilter 方法，所以过滤器就是 this。

下面是 eventFilter 方法的实现代码，只过滤 paint 事件即可，其他传给基类自己去玩。

bool MyWindow::eventFilter(QObject *obj, QEvent *event){    // 如果是paint事件    // 这里“与”判断事件接收者是不是在那三个子组件中    // 防止有其他意外对象出现    // 不过这里不会发生，因为只有install了过滤器的对象才会被拦截事件    if(event->type() == QEvent::Paint        && (obj==w1 || obj==w2 || obj==w3))    {        QPaintEvent* pe = static_cast(event);        QWidget* uiobj = static_cast(obj);        QPainter painter;        // 注意这里，绘图设备不是this了，而是接收绘图事件的对象        // 由于它要求的类型是QPaintDevcie*，所以要进行类型转换        // 转换后的uiobj变量的类型是QWidget*，传参没问题        painter.begin(uiobj);        if(w1 == uiobj)        {            // 红色            paintSomething(&painter, QColor("red"), pe->rect());        }        if(w2 == uiobj)        {            // 橙色            paintSomething(&painter, QColor("orange"), pe->rect());        }        if(w3 == uiobj)        {            // 紫色            paintSomething(&painter, QColor("purple"), pe->rect());        }        painter.end();        return true;    }    return QWidget::eventFilter(obj, event);}

拦截并处理了 paint 事件后，记得返回 true，这样事件就不会传给目标对象了（咱们帮它处理了，不必再重复处理，毕竟 QWidget 类默认的 paint 事件是啥也不做）。

下面代码是 paintSomething 方法。只是画了颗巨型青春痘……哦不，是一个椭圆。

void MyWindow::paintSomething(QPainter *p, const QColor &color, const QRect &paintRect){    // 设置画刷    p->setBrush(QBrush(color));    // 无轮廓    p->setPen(Qt::NoPen);    // 画椭圆    p->drawEllipse(paintRect);}

setPen中设定 NoPen 是为了在绘制圆时去掉轮廓，默认会画上轮廓线的。

最后，该到 main 函数了。

int main(int argc, char **argv){    QApplication app(argc,argv);    MyWindow wind;    // 窗口标题    wind.setWindowTitle("干点杂活");    // 调整窗口大小    wind.resize(321, 266);    wind.show();    return QApplication::exec();}

运行一下，看，横躺着三颗痘痘，多好看。

再来一例，这次咱们拦截的是窗口的 close 事件，当窗口要关闭的时候，咱们输出一条调试信息。

#ifndef 奶牛#define 奶牛#include #include class MyFilter : public QObject{protected:    bool eventFilter(QObject *obj, QEvent *e) override;};#endif

这次我们不从任何可视化类型派生，而是直接派生自 QObject 类。这里只是重写 eventFilter 方法，没有用到信号和 cao，所以，可以不加 Q_OBJECT 宏。也就是说咱们这个过滤器是独立用的，不打算加入到 Qt 的对象树中。

下面是实现代码：

bool MyFilter::eventFilter(QObject *obj, QEvent *e){    if(e->type() == QEvent::Close)    {        // 此处要类型转换        QWidget* window = qobject_cast(obj);        // 看看这货是不是窗口（有可能是控件）        if(window->windowFlags() & Qt::Window)        {            // 获取这个窗口的标题            QString title = window->windowTitle();            // 输出调试信息            qDebug() << "正在关闭的窗口：" << title;        }    }    // 事件继续传递    return false;}

最好返回 false，把事件继续传递给窗口，毕竟窗口可能在关闭时要做一些重要的事，比如保存打开的文件。QWidget 的 WindowFlags 如果包含 Window 值，表明它是一个窗口。

下面直接写main函数。

int main(int argc, char **argv){    QApplication app(argc, argv);    MyFilter *filter = new MyFilter;    // 弄三个窗口试试    QWidget *win1 = new QWidget;    win1->setWindowTitle("狗头");    win1->installEventFilter(filter);    win1->show();    QWidget *win2 = new QWidget;    win2->setWindowTitle("鸡头");    win2->installEventFilter(filter);    win2->show();    QWidget *win3 = new QWidget;    win3->setWindowTitle("鼠头");    win3->installEventFilter(filter);    win3->show();    return QApplication::exec();    // 可选    delete filter;    filter = nullptr;}

filter 是指针类型，它没有添加到 Qt 对象树中，不会自动清理，在exec返回后用 delete 解决它。在清理时有个好习惯，就是 del 之后把指针变量重设为 null，这样下次再引用变量时不容易产生错误，只要 if(! filter) 就能测出它是空的。

反正程序都退出了，所以此处你也可以让它泄漏一下也无妨。程序挂了后进程空间会被系统收回。

当然，用Qt专供的“作用域”指针也不错，超出作用域自动XX掉。

int main(int argc, char **argv){    QApplication app(argc, argv);    QScopedPointer filter(new MyFilter);    // 弄三个窗口试试    QWidget *win1 = new QWidget;    win1->setWindowTitle("狗头");    win1->installEventFilter(filter.data());    win1->show();    QWidget *win2 = new QWidget;    win2->setWindowTitle("鸡头");    win2->installEventFilter(filter.data());    win2->show();    QWidget *win3 = new QWidget;    win3->setWindowTitle("鼠头");    win3->installEventFilter(filter.data());    win3->show();    return QApplication::exec();}

QScopedPointer 通过构造函数引用要封装的对象，要访问被封装的指针对象，可以使用 data 成员。

运行之后，会出现三个窗口。逐个关闭，会输出以下调试信息：

---------------------------------------------------------------------------------------

最后老周扯点别的。

咱们知道，Qt官方推出 Python for Qt，名曰 PySide。五月份的时候，老周遇到一个问题：PySide6 无法加载 QML 文件，报的错误是加载 dll 失败，找不到指定的模块。

网上的方法都是不行的，首先，Qt 在版本号相同（均为 6.5.1）的情况下，C++是可以正常加载 QML 文件的。不管是生成资源文件还是直接访问文件均可。但 Python 是报错的。这至少说明我的机器上不缺某些 .dll，不然C++代码应该也报错。

接着，老周想是不是Qt官方编译的有问题，于是，我把自己编译的Qt动态库替换 PySide6 里面的动态链接库。报错依旧，那就排除编译的差异性。

那么，老周就想到，就是 Python 的问题了，3.7 到 3.10 几个版本测试也报错；用不同路径建的虚拟环境也报错；更换 Qt 版本（6.0 到 6.5）同样报错。

这时可以直接肯定就是 Python 的问题了。不是版本号的问题，是 Windows 商店安装的 Python 就会报错，非 Windows 商店安装的就正常。

不过，还得再加一句话：想把 Qt 用得 666 还是用 C++ 吧，用 Python 仅适合初学和娱乐。由于 Rust 可以调用 C/C++ 代码，所以你是可以尝试用 Rust 的。Rust 也不是什么鬼自动内存管理，要 GC 用 .NET 就完事了。Rust 的重点是内存安全。看似挺诱人，官方也把牛吹得入木四分。可用了之后（和用 Go 一样的感觉），是真的没 C++ 好用。C++ 能背负上这么多的历史包袱也不是靠吹的。当然 C++ 内存泄漏也没你想的那么恐怖。养成好习惯，作用域短，存放数据不多的对象就直接栈分配就行了；要在不同代码上下文传递对象，或分配的数据较大的，用指针。指针类型的变量，在不要的时候坚决干掉，然后记得设置变量为 nullptr。养成这些好习惯基本没多大问题。

一般代码你写惯了是不会忘记 delete 的，容易遗漏的是庞大复杂的代码之间会共享某些对象，在很多地方会引用到某对象。于是，码着码着就头晕了，就不记得销毁了。

会被多处引用的对象，可以写上注释提醒自己或别人要清理它，或者加个书签。写完代码后去看看书签列表，就会想起有哪些对象还没销毁。代码写复杂了会容易混，经常会访问已清理的对象。于是，不妨在访问指针变量前 if 语句一下，if (ptr)，在 bool 表达式中，若指针类型的变量是空会得到 false，非空为 true。这样就可以避免许多低级错误。

哪怕是不常用指针的语言也不见得不出事。C# 里面你要是访问 null 的变量（VB 是 Nothing）也会报那个很经典的错误：“未将对象引用设置到对象的实例”，就是 NullReferenceException。在.NET 代码中你只要看到这货就得明白肯定有某个为 null 的对象被访问了。

C++ 里面，这样写就能实例化 MyClass 类，只是分配在栈上。