Qt 实战（6）事件 | 6.3、自定义事件

前言：

Qt 是一个跨平台的 C++ 图形用户界面应用程序开发框架，它广泛用于开发 GUI程序（注意：GUI的全称是Graphical User Interface，中文意思为图形用户界面）以及非 GUI 程序，如控制台工具和服务器。在 Qt 中，事件处理是应用程序与用户交互的核心部分。Qt 提供了丰富的事件类型，但有时候，你可能需要自定义事件来满足特定的需求。下面，我们将详细介绍如何在 Qt 中自定义事件。

一、自定义事件

1、自定义事件类型

首先，你需要为你的自定义事件定义一个唯一的事件类型。Qt 允许你使用 QEvent::Type 枚举值来区分不同的事件类型。由于 Qt 的内置事件类型已经很多，你需要从 QEvent::registerEventType() 函数获取一个唯一的事件类型标识符。

#include <QEvent>  
  
// 定义一个全局的变量来存储自定义事件类型  
static const QEvent::Type MyCustomEvent = static_cast<QEvent::Type>(QEvent::registerEventType());

2、创建自定义事件类

接下来，你需要创建一个继承自 QEvent 的类来表示你的自定义事件。在这个类中，你可以添加任何你需要的成员变量和成员函数，如下：

class MyCustomEventEvent : public QEvent  
{  
public:  
    explicit MyCustomEventEvent(const QString &message)  
        : QEvent(MyCustomEvent), m_message(message) {}  
  
    // 允许外部访问 m_message  
    QString message() const { return m_message; }  
  
private:  
    QString m_message;  
};

3、发送自定义事件

现在，你可以在你的应用程序中的任何地方创建并发送这个自定义事件了。通常，你会使用 QCoreApplication::postEvent() 或 QObject::event() 方法来发送事件。

// 假设你有一个QObject的子类实例名为myObject  
MyCustomEventEvent *event = new MyCustomEventEvent("Hello, this is a custom event!");  
QCoreApplication::postEvent(myObject, event);  

4、处理自定义事件

为了处理你的自定义事件，你需要在你的 QObject 子类中重写 event() 方法，并检查事件类型。然后，你可以根据事件类型调用适当的槽函数或直接在 event() 方法中处理事件。

class MyObject : public QObject  
{  
    Q_OBJECT  
  
public:  
    using QObject::QObject;  
  
protected:  
    bool event(QEvent *event) override {  
        if (event->type() == MyCustomEvent) {  
            MyCustomEventEvent *myEvent = static_cast<MyCustomEventEvent *>(event);  
            qDebug() << "Received custom event with message:" << myEvent->message();  
            // 处理事件...  
            return true; // 表示事件已处理  
        }  
        return QObject::event(event); // 调用基类的 event() 来处理其他事件  
    }  
};

5、总结

通过以上步骤，你可以在 Qt 中定义、发送和处理自定义事件。自定义事件是 Qt 强大事件系统的一部分，允许你创建高度自定义和灵活的应用程序。记得在你的应用程序中适当使用事件系统，以保持代码的清晰和可维护性。