Qt 的 事件队列

Qt 的 事件队列 是其核心事件处理机制之一，用于管理和分发系统与用户生成的事件（如鼠标点击、键盘输入、定时器、信号槽中的队列连接等）。理解 Qt 的事件队列对多线程、界面响应以及异步处理尤为关键。

一、Qt 的事件处理模型概览

Qt 是基于 事件驱动模型 的，每个继承自 QObject 的对象可以通过重载 QObject::event() 或特定事件处理器（如 mousePressEvent()）响应事件。

这些事件由 QCoreApplication 或 QApplication 管理的 事件循环（Event Loop） 从 事件队列 中取出并派发。

二、事件队列的来源

事件队列中的事件通常有以下几种来源：

1. 系统事件：比如鼠标点击、键盘输入（由操作系统提供）。

2. Qt内部事件：如定时器事件（QTimer）、绘图事件（QPaintEvent）等。

3. 自定义事件：可以通过 QEvent 派生类，自定义事件类型。

4. 跨线程信号槽通信：使用 QueuedConnection 连接类型时，信号通过事件队列传递。

三、事件队列的添加方式

1. 使用 QCoreApplication::postEvent()

用于向某个对象发送一个自定义事件（异步发送，加入事件队列）。

QCoreApplication::postEvent(receiver, new QCustomEvent());
2. 使用 QTimer::singleShot()

 实现延时异步事件，也会通过事件队列调度：

QTimer::singleShot(0, receiver, SLOT(handleLater()));
四、事件循环（Event Loop）

事件循环负责不断从事件队列中取事件，并分发处理。主事件循环由 QApplication::exec() 启动： 

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);
    MainWindow w;
    w.show();
    return app.exec(); // 启动主事件循环
}

你也可以在工作线程中创建自己的事件循环：
 QEventLoop loop;
loop.exec(); // 启动局部事件循环

五、跨线程通信和事件队列

当两个 QObject 分属不同线程，并用 QueuedConnection 连接时：

• 信号被封装成一个事件，放入接收者所属线程的事件队列。

• 槽函数将在目标线程的事件循环中执行。

• QObject::connect(sender, &Sender::signal1, receiver, &Receiver::slot1, Qt::QueuedConnection);

只要目标线程有事件循环在运行（例如主线程或调用了 exec() 的线程），信号就会在目标线程执行。 

六、事件队列相关的类 

QEvent

所有事件的基类

QCoreApplication

负责事件调度和投递

QEventLoop

事件循环对象

QThread

每个线程都可拥有自己的事件队列

QTimer

基于事件队列的定时器

QMetaObject::invokeMethod()

支持跨线程调用槽函数，使用事件队列传递

七、事件队列调试技巧 

• 使用 qDebug() 打印调试信息。

• 对自定义事件使用 QEvent::type() 区分处理。

• 使用 QCoreApplication::removePostedEvents() 移除队列中的事件。

• 如果跨线程信号没有响应，检查接收对象是否有事件循环。

• 总结一句话

  Qt 的事件队列是一个线程安全的机制，它确保事件（包括跨线程信号）按照顺序、安全地投递给合适的对象，只要该对象所在的线程在运行事件循环。