【VS Code 与 Qt6】运用事件过滤器批量操作子级组件
阅读原文时间:2023年08月09日阅读:4

如果某个派生自 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_OBJECT
public:
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<MyFilter> 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 类,只是分配在栈上。

MyClass x;

但在 C# 中,初始值是 null,即未初始化的,初始化你还得 new。哦,顺便想起个事,C# 中数据的隐式基类是 Array,所以它是引用类型,初始值也是 null 的,就算你数据组里面的元素是值类型,但数组自身是引用类型。委托也是引用类型。有的刚入门的同学会以为委托是值类型。

C++函数按“引用”传值的话,一般会用到指针、引用参数,如 int *p、const int &a、const char *w(不能改)等,C# 中如果是引用类型,直接声明就行了,如 MyClass x,值类型可以用 ref 关键字,ref int v。

C# 中 int?、double? 等可以让其成为引用类型,你可以类比 C 中的 int* 等。

手机扫一扫

移动阅读更方便

阿里云服务器
腾讯云服务器
七牛云服务器