如何确保QTest::keyClick()在之前操作的重绘完成后执行？

我有一个需要用QTest测试的GUI，打算在独立线程里执行QTest::keyClick()测试步骤，希望把测试步骤和QWidget::repaint()同步——也就是每个QTest::keyClick()必须在前一个QTest::keyClick()引发的重绘（如果有的话）完成后再执行。

期望流程 #

1. 执行QTest::keyClick()
2. 等待步骤1引发的重绘完成
3. 执行下一次QTest::keyClick()
4. 等待步骤3引发的重绘完成

不期望流程 #

1. 执行QTest::keyClick()
2. 立即执行下一次QTest::keyClick()
3. 处理步骤1引发的重绘
4. 处理步骤2引发的重绘

解决方案 #

这里提供几种可靠的实现方式：

1. 事件过滤器跟踪重绘完成

给目标Widget安装事件过滤器，监听QPaintEvent并标记重绘完成状态，配合QApplication::processEvents()等待：

class PaintWaiter : public QObject
{
    Q_OBJECT
private:
    bool m_paintDone = false;
protected:
    bool eventFilter(QObject* obj, QEvent* event) override
    {
        if (event->type() == QEvent::Paint)
        {
            // 先让Widget处理绘制事件，再标记完成
            QObject::eventFilter(obj, event);
            m_paintDone = true;
            return true;
        }
        return QObject::eventFilter(obj, event);
    }
public:
    void waitForPaint(QWidget* widget)
    {
        m_paintDone = false;
        widget->installEventFilter(this);
        widget->repaint();
        // 循环处理事件直到重绘完成
        while (!m_paintDone)
        {
            QApplication::processEvents(QEventLoop::WaitForMoreEvents);
        }
        widget->removeEventFilter(this);
    }
};

使用示例：

PaintWaiter waiter;
QTest::keyClick(targetWidget, Qt::Key_A);
waiter.waitForPaint(targetWidget);
QTest::keyClick(targetWidget, Qt::Key_B);
waiter.waitForPaint(targetWidget);

2. 结合QTest::qWaitFor()与自定义状态判断

如果你的Widget有暴露绘制状态的接口（比如isPaintingDone()方法），可以直接用QTest::qWaitFor()等待条件满足：

QTest::keyClick(targetWidget, Qt::Key_A);
// 超时时间设为5秒，避免无限等待
QTest::qWaitFor([&](){ return targetWidget->isPaintingDone(); }, 5000);
QTest::keyClick(targetWidget, Qt::Key_B);
QTest::qWaitFor([&](){ return targetWidget->isPaintingDone(); }, 5000);

3. 利用QWidget::updateRequest()信号（Qt 5.10+）

监听Widget的updateRequest()信号，通过QEventLoop等待重绘处理完成：

void waitForRepaint(QWidget* widget)
{
    QEventLoop loop;
    QObject::connect(widget, &QWidget::updateRequest, &loop, [&]() {
        QApplication::processEvents();
        loop.quit();
    });
    widget->repaint();
    loop.exec();
}

调用方式和第一种方案一致，每次keyClick()后调用该函数即可。

注意事项 #

• 若在独立线程执行测试，必须确保线程已启动QEventLoop，否则事件处理相关逻辑无法正常工作。
• 所有等待逻辑建议设置超时时间，防止因异常情况导致测试卡住。
• 部分场景下keyClick()可能不会直接触发重绘，需根据GUI实际逻辑调整等待条件。

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