如何在Qt中实现无关联对象间的自定义事件传递？

问题 #

想要在两个Qt对象间传递自定义事件，但不想让二者产生耦合。常规用QApplication::sendEvent发送自定义事件时必须指定接收者指针，若两个对象处于不同作用域（如UI组件与数据库管理对象），共享指针存在风险。

为此实现了一个EventDispatcher类作为中间层：发送方向调度器发事件，接收方订阅调度器，二者无需知晓彼此，但调度器需全局可访问。简化代码如下：

EventDispatcher.h #

class EventDispatcher : public QObject
{
public:
    EventDispatcher() = default;
    bool event(QEvent* e) override;

    void registerObj(QObject* obj)
    {
        subscribers.push_back(obj);
    }

private:
    std::vector<QObject*> subscribers;
};

EventDispatcher.cpp #

bool EventDispatcher::event(QEvent *e)
{
    if(e->type() == QCustomEvent::type())
    {
        // getValue是QCustomEvent的自定义方法
        qDebug() << "custom event received. Value: " << ((QCustomEvent*)e)->getValue();
        for(auto* s : subscribers)
            QApplication::sendEvent(s, e);
        return true;
    }
    return QObject::event(e);
}

事件发送示例 #

// QCustomEvent继承自QEvent
QCoreApplication::sendEvent(g_eventDispatcherInstance, new QCustomEvent());

订阅示例 #

g_evd->registerObj(ui->widget_4);

// 在widget_4的bool event(QEvent* ev) override方法中处理自定义事件

疑问：是否存在更简洁的实现，无需自定义调度器类，仅用Qt原生类就能实现发送方与接收方无耦合的事件传递？这类调度器是否不可避免？

回答 #

完全可以用Qt原生机制替代自定义调度器，核心思路是利用QCoreApplication作为全局事件枢纽，结合事件过滤器实现无耦合事件传递，无需额外编写调度器类：

方案1：基于QApplication的事件过滤器 #

这是最贴合Qt事件机制的原生方案，QApplication本身就是全局可访问的对象，天然承担调度器的角色：

1. 注册唯一的自定义事件类型
   先确保自定义事件类型全局唯一，避免与内置事件冲突：

   // 全局作用域或头文件中定义
   static const QEvent::Type CustomEventType = static_cast<QEvent::Type>(QEvent::registerEventType());
   

2. 接收方实现事件过滤器并安装到QApplication
   接收方通过给QApplication安装事件过滤器，监听全局范围内的自定义事件：

   class ReceiverWidget : public QWidget {
       Q_OBJECT
   public:
       explicit ReceiverWidget(QWidget* parent = nullptr) : QWidget(parent) {
           // 给全局QApplication安装事件过滤器
           qApp->installEventFilter(this);
       }
   
   protected:
       bool eventFilter(QObject* obj, QEvent* e) override {
           // 过滤目标自定义事件
           if (e->type() == CustomEventType) {
               auto customEvent = static_cast<QCustomEvent*>(e);
               // 处理事件逻辑
               qDebug() << "Received custom event value:" << customEvent->getValue();
               return true; // 阻止事件继续传播（可选）
           }
           // 其他事件交给父类处理
           return QWidget::eventFilter(obj, e);
       }
   };
   

3. 发送方向QApplication发送事件
   发送方无需知道任何接收方，直接向QApplication发送自定义事件即可：

   // 使用postEvent让Qt自动管理事件内存（推荐）
   QCoreApplication::postEvent(qApp, new QCustomEvent(CustomEventType, targetValue));
   // 若用sendEvent，需手动管理事件内存：发送后自行delete
   // QCoreApplication::sendEvent(qApp, new QCustomEvent(CustomEventType, targetValue));
   // delete event;
   

方案2：基于Qt信号槽的全局事件总线 #

如果不需要严格遵循Qt事件机制，也可以用信号槽实现类似效果，利用一个全局的QObject作为信号发射源：

1. 定义全局信号总线

   // 全局单例对象
   class GlobalEventBus : public QObject {
       Q_OBJECT
   public:
       static GlobalEventBus* instance() {
           static GlobalEventBus bus;
           return &bus;
       }
   
   signals:
       void customEventTriggered(int value); // 自定义信号，携带事件数据
   };
   

2. 接收方连接信号

   // 在接收方初始化时连接信号
   connect(GlobalEventBus::instance(), &GlobalEventBus::customEventTriggered,
           this, [this](int value) {
               // 处理事件逻辑
               qDebug() << "Received custom signal with value:" << value;
           });
   

3. 发送方触发信号

   GlobalEventBus::instance()->customEventTriggered(targetValue);
   

对比自定义调度器的优势 #

• 无需编写额外的调度器类，完全依赖Qt原生组件，减少代码维护成本
• 事件过滤器方案中，当接收方对象销毁时，QApplication会自动移除对应的事件过滤器，避免悬空指针问题（你的原始调度器未处理订阅对象销毁的情况，存在野指针风险）
• postEvent由Qt事件循环管理内存，无需手动处理，更安全

内容的提问来源于stack exchange，提问作者pio