QEventLoop入门

什么是 QEventLoop？

QEventLoop 是 Qt 框架中的一个核心类，用于管理事件循环。事件循环是 Qt 应用程序的核心机制，负责处理各种事件，如用户输入、定时器、网络通信等。

基本概念

事件循环的工作原理

1. 循环开始运行

2. 检查事件队列中是否有待处理事件

3. 如果有事件，则处理该事件

4. 如果没有事件，则等待新事件到来

5. 重复上述过程

主事件循环

每个 Qt 应用程序都有一个主事件循环，通常由 QCoreApplication::exec() 或 QApplication::exec() 启动。

使用 QEventLoop

基本用法

#include <QCoreApplication>
#include <QEventLoop>
#include <QTimer>

int main(int argc, char *argv[])
{
    QCoreApplication app(argc, argv);
    
    QEventLoop loop;
    QTimer::singleShot(2000, &loop, &QEventLoop::quit);
    
    qDebug() << "Before event loop";
    loop.exec();
    qDebug() << "After event loop";
    
    return app.exec();
}

常见使用场景

1. 同步等待异步操作完成

   QNetworkAccessManager manager;
   QEventLoop loop;
   
   QObject::connect(&manager, &QNetworkAccessManager::finished, &loop, &QEventLoop::quit);
   
   QNetworkReply *reply = manager.get(QNetworkRequest(QUrl("http://example.com")));
   loop.exec();
   
   // 此时请求已完成
   qDebug() << reply->readAll();

2. 创建局部事件循环

   void performTaskWithTimeout()
   {
       QEventLoop loop;
       QTimer timer;
       
       // 设置超时
       timer.setSingleShot(true);
       QObject::connect(&timer, &QTimer::timeout, &loop, &QEventLoop::quit);
       timer.start(5000); // 5秒超时
       
       // 启动任务
       startSomeAsyncOperation();
       
       // 等待操作完成或超时
       loop.exec();
       
       if (timer.isActive()) {
           // 操作完成
           qDebug() << "Operation completed";
       } else {
           // 超时
           qDebug() << "Operation timed out";
       }
   }

注意事项

1. 避免在主线程中阻塞：在主事件循环中使用嵌套事件循环时要小心，可能导致界面冻结。

2. 递归调用：事件循环可以嵌套，但要确保有退出条件，避免无限递归。

3. 内存管理：确保在事件循环退出前，所有相关对象都有效。

4. 替代方案：考虑使用信号槽机制或 QFuture/QPromise 等更现代的异步编程方式。

高级用法

自定义事件处理

class MyEventLoop : public QEventLoop
{
protected:
    bool eventFilter(QObject *watched, QEvent *event) override
    {
        if (event->type() == QEvent::KeyPress) {
            // 处理按键事件
            return true; // 事件已处理
        }
        return QEventLoop::eventFilter(watched, event);
    }
};

与 QThread 配合使用

void WorkerThread::run()
{
    QEventLoop loop;
    
    // 设置工作对象
    Worker worker;
    QObject::connect(&worker, &Worker::finished, &loop, &QEventLoop::quit);
    
    // 开始工作
    QTimer::singleShot(0, &worker, &Worker::start);
    
    loop.exec();
}