Qt 自定义事件的发送与处理

一、postEvent方式发送处理自定义事件

1、基本流程

(1)、自定义事件类型

• Qt 中有时需要用到自定义的事件，此时需要先自定义一个事件对应的枚举类型QEvent::Type。
• Qt允许的自定义事件取值范围在 QEvent::User 与QEvent::MaxUser之间，即值在：1000 ~ 65535之间（包含两端值）。
• 自定义事件的取值可以用 QEvent::User来加一个数字表示，最后必须要将其转换成QEvent::Type类型的。如自定义一个值为 1001的事件，可以使用如下方式：
  #define SELF_BTN_EVENT QEvent::Type(QEvent::User+0001)

(2)、发送自定义的事件postEvent

• 使用 QApplication::postEvent 函数来发送自定义的事件到指定的对象上。其参数包括：事件的接收对象、发送的事件以及事件的优先级。
• 参数发送的事件在此因为必须要分配到堆上的，所以只能通过new的方式来进行创建，而不能创建在栈上。
• 事件的优先级默认值为正常的优先级，一般会采用默认值。
• 通过该方式发送事件后，事件队列就会拥有该事件，并立即删除创建时所new的事件。因此在发送事件之后，再访问该事件是不安全的，因为已经被自动的delete了。
• 该函数是线程安全的。

(3)、接收处理自定义的事件customEvent

• 使用customEvent(QEvent *event)函数来接收postEvent所发送的自定义事件。
• 通过重写虚函数customEvent(QEvent *event)，来对指定的自定义事件进行处理。

2、应用示例

(1)、示例说明

点击按钮开始计时，当数字到10的时候，开始触发自定义事件，来显示时间到。

(2)、代码及效果如下

/*********** Pr05_QtEvent.h *************/
#pragma once

#include <QtWidgets/QWidget>
#include "ui_Pr05_QtEvent.h"
#include <QEvent>
#include <QTimer>

class Pr05_QtEvent : public QWidget
{
    Q_OBJECT

public:
    Pr05_QtEvent(QWidget *parent = Q_NULLPTR);

protected:
    void ClickBtn(); //点击按钮槽函数
    void AddCount(); //计时器自动叠加槽函数
    void customEvent(QEvent *event); //接收自定义的函数

private:
    Ui::Pr05_QtEventClass       ui;
    QTimer                      timer; //计时器
    int                         cnt;
};

/*********** Pr05_QtEvent.cpp *************/
#include "Pr05_QtEvent.h"
#include <QMouseEvent>
#include <QLabel>

// 自定义事件的类型定义
#define SELF_BTN_EVENT    QEvent::Type(QEvent::User+1)

Pr05_QtEvent::Pr05_QtEvent(QWidget *parent)
    : QWidget(parent)
{
    ui.setupUi(this);
    timer.setInterval(300);

    connect(ui.btn, &QPushButton::clicked, this, &Pr05_QtEvent::ClickBtn);
    connect(&timer, &QTimer::timeout, this, &Pr05_QtEvent::AddCount);
}

void Pr05_QtEvent::ClickBtn()
{
    cnt = 0;
    timer.start();
}

void Pr05_QtEvent::AddCount()
{
    cnt++;
    ui.label->setText(QString::number(cnt));

    if (cnt == 11)
    {
        timer.stop();
        cnt = 0;
        //时间到之后就发送自定义事件到指定的对象上
        QApplication::postEvent(this, new QEvent(SELF_BTN_EVENT));
    }
}

// 接收自定义事件，并进行处理
void Pr05_QtEvent::customEvent(QEvent *event)
{
    if (event->type() == SELF_BTN_EVENT)
    {
        ui.label->setText("The time is out!");
    }
}

二、sendEvent方式发送处理自定义事件

1、sendEvent和postEvent方式基本相同，主要区别如下

• sendEvent发送的事件是创建在栈上的，而postEvent则是通过new来创建在堆上的。
• sendEvent直接将事件发送给指定的接收对象，并等待返回事件处理的结果(结果为bool类型)。 而postEvent是异步进行的，其发送事件之后就立即退出，并不会等待等待返回事件处理的结果。
• sendEvent由于是将发送事件创建在栈上，因此发送完事件后，不会将其删除。而postEvent则会在发送事件后将其创建的事件删除。
• 两种方式都可以用来发送Qt已定义的事件。

2、应用示例

主要区别如下：为发送事件的创建方式不同，其它均不变

QEvent curEvent(SELF_BTN_EVENT);
QApplication::sendEvent(this, &curEvent);