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 的事件隊列是一個線程安全的機制，它確保事件（包括跨線程信號）按照順序、安全地投遞給合適的對象，只要該對象所在的線程在運行事件循環。

?