Qt事件

1  简介

参考视频：https://www.bilibili.com/video/BV1XW411x7NU?p=31

参考资料：《Qt教程.docx》

本文主要介绍Qt的事件。

2  事件

（1）事件（event）

事件由系统或Qt本身在不同时刻发生的，例如按下鼠标、敲下键盘。

Qt程序需要在main()函数创建一个QApplication对象，然后调用它的exec()函数。这个函数就是开始Qt的事件循环，在执行exec()函数之后，程序将进入事件循环来监听应用程序的事件。但事件发生时，Qt将创建

一个事件对象，Qt中所有事件类都继承QEvent。在事件对象创建完毕后，将这个事件对象传递给QObject的event函数。

event()函数并不直接处理事件，而是按照事件对象的类型分派给特定的事件处理函数（event handler）。

（2）事件处理函数

在所有组件的父类QWidget中，定义了很多事件处理的回调函数，这些函数都是 protected virtual 的，也就是说，我们可以在子类中重新实现这些函数。

    

（3）测试

测试说明：创建一个QLabel，用于显示鼠标按下、释放、移动时的坐标，主要是为了测试鼠标按下、释放、移动这三个事件。

创建一个带ui的QWidget工程：

其中，mylabel是自定义的label，我们重写其鼠标事件：

mylabel.h中的代码如下：

#ifndef MYLABEL_H
#define MYLABEL_H

#include <QWidget>
#include <QLabel>

class mylabel : public QLabel
{
    Q_OBJECT
public:
    explicit mylabel(QWidget *parent = nullptr);

protected:
    //事件处理函数
    void mousePressEvent(QMouseEvent *ev);
    void mouseReleaseEvent(QMouseEvent *ev);
    void mouseMoveEvent(QMouseEvent *ev);

signals:

public slots:
};

#endif // MYLABEL_H

mylabel.cpp中的代码如下：

#include "mylabel.h"
#include <QMouseEvent>
#include <QString>

mylabel::mylabel(QWidget *parent) : QLabel(parent)
{
    this->setMouseTracking(true);
}

void mylabel::mousePressEvent(QMouseEvent *ev)
{
    QString text = QString("<center><h1>Mouse press:: (%1, %2)</h1></center>").arg(ev->x()).arg(ev->y());
    this->setText(text);
}

void mylabel::mouseReleaseEvent(QMouseEvent *ev)
{
    QString text = QString("<center><h1>Mouse release:: (%1, %2)</h1></center>").arg(ev->x()).arg(ev->y());
    this->setText(text);
}

void mylabel::mouseMoveEvent(QMouseEvent *ev)
{
    QString text = QString("<center><h1>Mouse move:: (%1, %2)</h1></center>").arg(ev->x()).arg(ev->y());
    this->setText(text);
}

上述代码中使用了QWidge的mouseTracking属性，该属性用于设置是否追踪鼠标。只有鼠标被追踪时，mouseMoveEvent()才会发出。如果mouseTracking是 false（默认即是），组件在至少一次鼠标点击之后，才能够被追踪，也就是能够发出mouseMoveEvent()事件。如果mouseTracking为 true，则mouseMoveEvent()直接可以被发出。

将ui中的label提升为我们自定义的label。运行进行测试：

3  event()函数

（1）介绍

事件对象创建完毕后，Qt 将这个事件对象传递给QObject的event()函数。event()函数并不直接处理事件，而是将这些事件对象按照它们不同的类型，分发给不同的事件处理器（event handler）。

event()函数主要用于事件的分发。

如果你希望在事件分发之前做一些操作，可以重写这个event()函数。

函数原型：virtual bool event(QEvent *event);

返回值说明：如果传入的事件已被识别并处理，则需要返回true，否则返回false。如果返回值是true，那么Qt会认为这个事件已经处理完毕，不再将这个事件发送给其它对象，而是会继续处理事件队列中的下一个事件。

（2）测试

功能：在event函数中判断主窗口的鼠标移动事件，并将鼠标所在的坐标在QLabel中显示出来。

工程文件有：

 在widget.h中声明event函数：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

namespace Ui {
class Widget;
}

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = 0);
    ~Widget();

protected:
    //事件分发
    bool event(QEvent *event);

private:
    Ui::Widget *ui;
};

#endif // WIDGET_H

在widget.cpp中实现event函数：

#include "widget.h"
#include "ui_widget.h"
#include <QEvent>
#include <QLabel>
#include <QString>
#include <QMouseEvent>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    this->setMouseTracking(true);
}

bool Widget::event(QEvent *event)
{
    //判断事件是否是鼠标移动
    if (event->type() == QEvent::MouseMove) {
        QMouseEvent *ent = static_cast<QMouseEvent *>(event);
        QString text = QString("<center><h1>Mouse move(%1, %2)</h1></center>").arg(ent->x()).arg(ent->y());
        ui->label->setText(text);
        //返回true，事件停止传播
        return true;
    } else{
        //其它事件继续传播
        return QWidget::event(event);
    }
}

Widget::~Widget()
{
    delete ui;
}

运行测试：

（3）总结

event()函数中实际是通过事件处理器来响应一个具体的事件。这相当于event()函数将具体事件的处理“委托”给具体的事件处理器。而这些事件处理器是 protected virtual 的，因此，我们重写了某一个事件处理

器，即可让Qt 调用我们自己实现的版本。

event()是一个集中处理不同类型的事件的地方。如果你不想重写一大堆事件处理器，就可以重写这个event()函数，通过QEvent::type()判断不同的事件。

4  事件过滤器

（1）介绍

有时候对象需要查看、甚至要拦截发送到另外对象的事件，需要用到事件过滤器。事件过滤器与event()、事件处理器的关系如下：

事件过滤器，可以理解成一种过滤代码，它会检查接收到的事件，如果这个事件是我们感兴趣的类型，就进行我们自己的处理；如果不是，就继续转发。

函数原型：virtual bool eventFilter(QObject *watched, QEvent *event);

事件过滤器会检查接收到的事件，如果这个事件是我们感兴趣的类型，就自己处理，否则继续转发。返回值是一个bool类型，如果你想将参数 event 过滤出来，比如，不想让它继续转发，就返回 true，否则返回 false。

（2）测试

功能：创建一个事件过滤器，过滤出label标签中的鼠标移动事件并进行处理。

工程代码：

widget.h中添加eventFilter()函数声明：

#ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>

namespace Ui {
class Widget;
}

class Widget : public QWidget
{
    Q_OBJECT

public:
    explicit Widget(QWidget *parent = 0);
    ~Widget();

protected:
    //事件过滤器
    bool eventFilter(QObject *watched, QEvent *event);

private:
    Ui::Widget *ui;
};

#endif // WIDGET_H

widget.cpp中添加实现eventFileter()函数，并过滤出Label对象的鼠标移动事件。

#include "widget.h"
#include "ui_widget.h"
#include <QLabel>
#include <QMouseEvent>
#include <QEvent>
#include <QString>

Widget::Widget(QWidget *parent) :
    QWidget(parent),
    ui(new Ui::Widget)
{
    ui->setupUi(this);
    //安装过滤器
    ui->label->installEventFilter(this);
    ui->label->setMouseTracking(true);
}

Widget::~Widget()
{
    delete ui;
}

bool Widget::eventFilter(QObject *watched, QEvent *event)
{
    //观察对象为label
    if (watched == ui->label) {
        QMouseEvent *ent = static_cast<QMouseEvent *>(event);
        //判断鼠标移动事件
        if (event->type() == QEvent::MouseMove) {
            QString text = QString("<center><h1>mouse move:(%1, %2)</h1></center>").arg(ent->x()).arg(ent->y());
            ui->label->setText(text);
            return true;
        }
    }
    //继续传递事件
    return QWidget::eventFilter(watched, event);
}

运行测试：