在上一篇文章中,我们介绍了Qt的事件,事件的传递顺序,在对象处理事件前会经过对象过滤器来来判断事件是否向该对象中传递。本章我们来介绍一下Qt对象的事件过滤器。
事件过滤器必须是继承自QObject的类或者继承了QObject的派生类的类,通过重写QObject类的eventFilter方法接收事件处理。
eventFilter函数的原型如下:
virtual bool eventFilter(QObject *watched, QEvent *event);
参数:watched是被监控的对象,event为事件
返回值:表示该事件是否被过滤。true, 表示该事件不传递到watched中,而false表示传递到watched对象中。
被监控的对象需要安装它的对象监视器,使用如下函数安装
void installEventFilter(QObject *);
下面是一个事件过滤器的例子,本章中在上一章的代码,添加的代码会在下面特别提出:
.h文件中的内容:
#ifndef WIDGET_H
#define WIDGET_H
#include <QWidget>
#include <QPushButton>
class PushButton : public QPushButton
{
Q_OBJECT
public:
PushButton(QWidget *parent = nullptr);
~PushButton();
protected:
virtual void mousePressEvent(QMouseEvent *event);
};
// -----------------------------------------------------------------------------------
class Widget : public QWidget
{
Q_OBJECT
public:
Widget(QWidget *parent = 0);
~Widget();
protected:
virtual void mousePressEvent(QMouseEvent *event);
private:
QPushButton *m_Button = nullptr;
};
// -----------------------------------------------------------------------------------
class EventWatcher : public QObject
{
Q_OBJECT
public:
EventWatcher(QObject *parent = nullptr);
~EventWatcher();
protected:
virtual bool eventFilter(QObject *obj, QEvent *event);
};
#endif // WIDGET_H
.cpp中的内容:
#include "widget.h"
#include <QVBoxLayout>
#include <QDebug>
#include <QMouseEvent>
PushButton::PushButton(QWidget *parent)
:QPushButton(parent)
{
this->setFixedSize(200, 200);
}
PushButton::~PushButton()
{
}
void PushButton::mousePressEvent(QMouseEvent *event)
{
QPushButton::mousePressEvent(event);
qDebug() << "MousePressed " << event->pos().x() << ", " << event->pos().y();
event->ignore();
}
// -----------------------------------------------------------------------------------
Widget::Widget(QWidget *parent)
: QWidget(parent)
{
m_Button = new PushButton(this);
m_Button->setText("OK");
// 安装过滤器
EventWatcher *watcher = new EventWatcher(this);
m_Button->installEventFilter(watcher);
QVBoxLayout *layout = new QVBoxLayout(this);
layout->addWidget(m_Button);
QObject::connect(m_Button, &QPushButton::clicked, [=](void)->void{
qDebug() << "PushButton Pressed!" ;
});
this->setGeometry(100, 100, 800, 600);
}
Widget::~Widget()
{
}
void Widget::mousePressEvent(QMouseEvent *event)
{
int xPt = event->pos().x();
int yPt = event->pos().y();
qDebug() << "QWidget " << xPt << ", " << yPt;
return QWidget::mousePressEvent(event);
}
// -----------------------------------------------------------------------------------
EventWatcher::EventWatcher(QObject *parent)
:QObject(parent)
{
}
EventWatcher::~EventWatcher()
{
}
bool EventWatcher::eventFilter(QObject *obj, QEvent *event)
{
if (event->type() == QEvent::MouseButtonPress || event->type() == QEvent::MouseButtonDblClick)
{
return true;
}
return QObject::eventFilter(obj, event);
}
从头文件的第37行开始,添加了一个监控者的类,源文件中的第32行中,按钮对象添加了该事件过滤器;
按钮的点击和双击事件被监控不向按钮这个对象传递,因此程序的运行效果为点击按钮无任何反应。