QTest Namespace

函数文档

template <typename T> void QTest::addColumn(const char *name, T *dummy = 0)

向当前测试数据中添加一个类型为T 的列。name 是该列的名称。dummy 是针对存在缺陷的编译器的临时解决方案，可以忽略。

要为该列填充值，可使用newRow()。在实际测试中，请使用QFETCH() 来获取数据。

示例：

    QTest::addColumn<int>("intval");
    QTest::addColumn<QString>("str");
    QTest::addColumn<double>("dbl");
    QTest::newRow("row1") << 1 << "hello" << 1.5;

更详尽的示例请参阅“数据驱动测试”。

另请参阅 QTest::newRow()、QFETCH() 以及QMetaType 。

QTestData &QTest::addRow(const char *format, ...)

将新行追加到当前测试数据中。

该函数的参数将传递给 std::snprintf()，并根据format 进行格式化。有关注意事项和限制，请参阅std::snprintf() 的文档。

测试输出将使用此格式化生成的名称，来标识使用该测试数据进行的测试运行。

返回一个 QTestData 引用，可用于流式导入数据，表中的每一列对应一个值。

示例：

    QTest::addColumn<int>("input");
    QTest::addColumn<QString>("output");
    QTest::addRow("%d", 0) << 0 << QString("0");
    QTest::addRow("%d", 1) << 1 << QString("1");

更详尽的示例请参阅“数据驱动测试”。

另请参阅 newRow()、addColumn() 以及QFETCH()。

const char *QTest::benchmarkMetricName(QTest::QBenchmarkMetric metric)

将枚举值metric 作为字符串返回。

const char *QTest::benchmarkMetricUnit(QTest::QBenchmarkMetric metric)

返回指定metric 的计量单位。

QPointingDevice *QTest::createTouchDevice(QInputDevice::DeviceType devType = QInputDevice::DeviceType::TouchScreen, QInputDevice::Capabilities caps = QInputDevice::Capability::Position)

创建一个类型为devType 、具备caps 功能的虚拟触摸设备，用于模拟触摸事件。

该触摸设备将注册到 Qt 窗口系统接口中。通常，您应在测试用例类中使用 createTouchDevice() 初始化一个QPointingDevice 成员变量，在所有测试中使用同一个实例，并在不再需要时将其删除。

另请参阅 QTest::QTouchEventSequence 和touchEvent()。

const char *QTest::currentAppName()

返回当前正在执行的二进制文件的名称。

const char *QTest::currentDataTag()

返回当前测试数据的名称。如果该测试未分配任何测试数据，则该函数返回nullptr 。

[since 6.11] const char *QTest::currentGlobalDataTag()

返回当前全局测试数据的名称。如果该测试未分配任何全局测试数据，则该函数返回nullptr 。

该函数在 Qt 6.11 中引入。

bool QTest::currentTestFailed()

如果当前测试函数失败，则返回true ；否则返回false。

另请参阅 QTest::currentTestResolved()。

const char *QTest::currentTestFunction()

返回当前正在执行的测试函数的名称。

示例：

void MyTestClass::cleanup()
{
    if (qstrcmp(QTest::currentTestFunction(), "myDatabaseTest") == 0) {
        // clean up all database connections
        closeAllDatabases();
    }
}

[since 6.5] bool QTest::currentTestResolved()

如果当前测试函数失败或被跳过，则返回true 。

当测试失败或触发了跳过时，此规则适用。当该值为真时，测试函数应提前返回。 特别是，当在测试函数（但不包括其 cleanup()）中执行时，QTRY_* 宏和测试事件循环会提前终止其循环。测试调用了一个使用本模块宏的辅助函数后，可以使用此函数来判断是否应提前返回。

该函数于 Qt 6.5 中引入。

另请参阅 QTest::currentTestFailed()。

[since 6.3] void QTest::failOnWarning(const QRegularExpression &messagePattern)

对于每个符合messagePattern 条件的警告，都会在测试日志中追加一条测试失败记录。

添加失败记录后，测试函数将继续执行。若要中止测试，可检查currentTestFailed()，若其值为true ，则可提前返回。

对于每个警告，第一个匹配的模式将导致测试失败，其余模式将被忽略。

每个测试函数结束时，所有模式都会被清除。

voidFileTest::loadFiles()
{
    QTest::failOnWarning(QRegularExpression("^加载失败"));

    // 以下每种情况都会导致测试失败：
    qWarning() << "Failed to load image";
    qWarning() << "Failed to load video";
}

若要使所有触发特定警告的测试均失败，请在init() 中向该函数传递一个合适的正则表达式：

void FileTest::init()
{
    QTest::failOnWarning(
        QRegularExpression("QFile::.*: File(.*) already open"));
}

对于“遇到任何警告就失败”这一常见情况，请不传递任何参数：

void FileTest::init()
{
    QTest::failOnWarning();
}

该函数于 Qt 6.3 版本中引入。

另请参阅 QTEST_FATAL_FAIL。

[since 6.8] void QTest::failOnWarning()

如果输出任何警告，则将测试失败记录追加到测试日志中。

该函数在 Qt 6.8 中引入。

另请参阅 failOnWarning(const char *)。

[since 6.3] void QTest::failOnWarning(const char *message)

如果输出message ，则将测试失败记录追加到测试日志中。

该函数在 Qt 6.3 中引入。

另请参阅 failOnWarning()。

void QTest::ignoreMessage(QtMsgType type, const char *message)

忽略由qDebug()、qInfo() 或qWarning() 生成的消息。如果输出包含相应type 的message ，则将其从测试日志中移除。如果测试结束且未输出message ，则在测试日志末尾追加一条测试失败记录。

示例：

QDir dir;
QTest::ignoreMessage(QtWarningMsg, "QDir::mkdir: Empty or null file name(s)");
dir.mkdir("");

上面的示例用于测试当使用无效文件名调用QDir::mkdir() 时，该函数是否会输出正确的警告。

void QTest::ignoreMessage(QtMsgType type, const QRegularExpression &messagePattern)

忽略由qDebug()、qInfo() 或qWarning() 生成的消息。如果输出了一条与messagePattern 匹配且对应type 的消息，该消息将从测试日志中移除。如果测试已完成且该消息尚未输出，则会在测试日志末尾追加一条测试失败记录。

void QTest::keyClick(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟点击key ，可选modifier ，作用于widget 。如果delay 大于0，则测试将在点击键之前等待delay 毫秒。

示例：

QTest::keyClick(myWidget, Qt::Key_Escape);

QTest::keyClick(myWidget, Qt::Key_Escape, Qt::ShiftModifier, 200);

上面的第一个示例模拟在不使用任何键盘修饰键且无延迟的情况下，点击myWidget 上的escape 键。第二个示例模拟在测试延迟 200 毫秒后，点击myWidget 上的shift-escape 。

另请参阅 QTest::keyClicks()。

void QTest::keyClick(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟点击key （可选参数modifier ）在widget 上的操作。如果delay 大于0，测试将在点击该键前等待delay 毫秒。

示例：

QTest::keyClick(myWidget, 'a');

上面的示例模拟了在不使用任何键盘修饰键且测试无延迟的情况下，点击a 上的myWidget 按钮。

另请参阅 QTest::keyClicks()。

void QTest::keyClick(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟点击key 键，并可选地设置modifier ，操作在window 上进行。如果delay 大于0，则测试将在点击该键前等待delay 毫秒。

示例：

QTest::keyClick(&myWindow, Qt::Key_Escape);
QTest::keyClick(&myWindow, Qt::Key_Escape, Qt::ShiftModifier, 200);

上面的第一个示例模拟在不使用任何键盘修饰键且无延迟的情况下，点击escape 上的myWindow 键。第二个示例模拟在测试延迟 200 毫秒后，点击shift-escape 上的myWindow 。

另请参阅 QTest::keyClicks()。

void QTest::keyClick(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟点击key ，并可选指定modifier ，操作在window 上进行。如果delay 大于 0，测试将在点击该键前等待delay 毫秒。

示例：

QWidget myWindow;
QTest::keyClick(&myWindow, Qt::Key_Tab);

上面的示例模拟了在不使用任何键盘修饰键且测试无延迟的情况下，点击a 上的myWindow 。

另请参阅 QTest::keyClicks()。

void QTest::keyClicks(QWidget *widget, const QString &sequence, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟在widget 上点击sequence 的按键。可选地，可以指定键盘modifier ，以及每次按键前测试的delay （单位为毫秒）。

示例：

QTest::keyClicks(myWidget, "hello world");

上面的示例模拟了在myWidget 上点击代表“hello world”的键序列，不使用任何键盘修饰键，且测试中不设置延迟。

另请参阅 QTest::keyClick()。

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

向widget 发送一个Qt键盘事件，该事件包含给定的key 和关联的action 。可选地，可以指定键盘modifier ，以及发送事件前测试的delay （单位为毫秒）。

void QTest::keyEvent(QTest::KeyAction action, QWidget *widget, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

向widget 发送一个Qt键事件，该事件包含给定的键ascii 及其关联的action 。可选地，可以指定键盘modifier ，以及在发送事件前测试的delay （单位为毫秒）。

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

向window 发送一个Qt键事件，该事件带有给定的key 和关联的action 。可选地，可以指定键盘modifier ，以及在发送事件前测试的delay （单位为毫秒）。

void QTest::keyEvent(QTest::KeyAction action, QWindow *window, char ascii, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

向window 发送一个Qt键事件，该事件包含给定的键ascii 及其关联的action 。可选地，可以指定键盘modifier ，以及在发送事件前测试的delay （单位为毫秒）。

void QTest::keyPress(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟按下key 键，并可选地同时按下modifier 键，该操作在widget 设备上进行。如果delay 大于 0，则测试将在按下该键前等待delay 毫秒。

另请参阅 QTest::keyRelease() 和QTest::keyClick()。

void QTest::keyPress(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟按下key 键，并可选地在widget 上使用modifier 。如果delay 大于 0，则测试将在按下该键前等待delay 毫秒。

另请参见 QTest::keyRelease() 和QTest::keyClick()。

void QTest::keyPress(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟按下key 键，并可选地设置modifier ，该操作在window 上执行。如果delay 大于 0，则测试将在按下该键前等待delay 毫秒。

另请参阅 QTest::keyRelease() 和QTest::keyClick()。

void QTest::keyPress(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟按下带有可选modifier 的key ，该键位于window 上。如果delay 大于0，则测试将在按下该键前等待delay 毫秒。

另请参见 QTest::keyRelease() 和QTest::keyClick()。

void QTest::keyRelease(QWidget *widget, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟在widget 上释放一个key ，并可选地设置modifier 。如果delay 大于0，则测试将在释放键之前等待delay 毫秒。

另请参阅 QTest::keyPress() 和QTest::keyClick()。

void QTest::keyRelease(QWidget *widget, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟在widget 上释放一个key ，并可选地指定modifier 。如果delay 大于0，则测试将在释放键之前等待delay 毫秒。

另请参阅 QTest::keyClick()。

void QTest::keyRelease(QWindow *window, Qt::Key key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟在window 上释放一个key ，并可选地指定modifier 。如果delay 大于0，则测试将在释放键之前等待delay 毫秒。

另请参阅 QTest::keyPress() 和QTest::keyClick()。

void QTest::keyRelease(QWindow *window, char key, Qt::KeyboardModifiers modifier = Qt::NoModifier, int delay = -1)

模拟在window 上释放一个key ，并可选地设置modifier 。如果delay 大于0，则测试将在释放键之前等待delay 毫秒。

另请参阅 QTest::keyClick()。

void QTest::keySequence(QWidget *widget, const QKeySequence &keySequence)

模拟在widget 中输入keySequence 的操作。

另请参阅 QTest::keyClick() 和QTest::keyClicks()。

void QTest::keySequence(QWindow *window, const QKeySequence &keySequence)

模拟在window 中输入keySequence 的操作。

另请参阅 QTest::keyClick() 和QTest::keyClicks()。

void QTest::mouseClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在widget 上点击鼠标button ，可选modifier 。点击位置由pos 定义；默认位置为控件中心。如果指定了delay ，测试将在按下和释放按钮前等待指定毫秒数。

另请参阅 QTest::mousePress() 和QTest::mouseRelease()。

void QTest::mouseClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在window 上单击鼠标button ，可选地配合stateKey 修饰符。单击位置由pos 定义；默认位置为窗口中心。如果指定了delay ，测试将在按下和释放按钮前分别等待指定毫秒数。

另请参阅 QTest::mousePress() 和QTest::mouseRelease()。

void QTest::mouseDClick(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在widget 上双击鼠标button ，并可选地设置modifier 。点击位置由pos 定义；默认位置为控件的中心。如果指定了delay ，测试将在每次按下和释放前等待指定的毫秒数。

另请参阅 QTest::mouseClick()。

void QTest::mouseDClick(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在window 上双击鼠标button ，可选地配合stateKey 修饰符。点击位置由pos 定义；默认位置为窗口中心。如果指定了delay ，测试将在每次按下和松开鼠标前等待指定的毫秒数。

另请参阅 QTest::mouseClick()。

void QTest::mouseMove(QWidget *widget, QPoint pos = QPoint(), int delay = -1)

将鼠标指针移动到widget 。如果未指定pos ，鼠标指针将移动到控件的中心。如果指定了delay （单位为毫秒），则系统会在移动鼠标指针之前进行等待。

void QTest::mouseMove(QWindow *window, QPoint pos = QPoint(), int delay = -1)

将鼠标指针移动到window 。如果未指定pos ，鼠标指针将移动到窗口中心。如果指定了delay （单位为毫秒），则测试将在移动鼠标指针前进行等待。

void QTest::mousePress(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在widget 上按下鼠标button ，并可选地设置modifier 。位置由pos 定义；默认位置为控件的中心。如果指定了delay ，则测试将在按下前等待指定的毫秒数。

另请参阅 QTest::mouseRelease() 和QTest::mouseClick()。

void QTest::mousePress(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在window 上按下鼠标button ，并可选地使用stateKey 修饰符。位置由pos 定义；默认位置为窗口中心。如果指定了delay ，则测试将在按下前等待指定的毫秒数。

另请参阅 QTest::mouseRelease() 和QTest::mouseClick()。

void QTest::mouseRelease(QWidget *widget, Qt::MouseButton button, Qt::KeyboardModifiers modifier = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在widget 上释放鼠标按钮button ，并可选指定modifier 。释放位置由pos 定义；默认位置为控件的中心。 如果指定了delay ，测试将在释放按钮前等待指定的毫秒数；否则，将等待默认时间（1 毫秒），该默认时间可通过命令行参数覆盖。

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

另请参阅 QTest::mousePress() 和QTest::mouseClick()。

void QTest::mouseRelease(QWindow *window, Qt::MouseButton button, Qt::KeyboardModifiers stateKey = Qt::KeyboardModifiers(), QPoint pos = QPoint(), int delay = -1)

模拟在window 上释放鼠标button ，可选stateKey 修饰符。释放位置由pos 定义；默认位置为窗口中心。 如果指定了delay ，测试将在释放按钮前等待指定毫秒数；否则，将等待默认时间（1 毫秒），该默认时间可通过命令行参数覆盖。

QSignalSpy doubleClickSpy(target, &TargetClass::doubleClicked);
const QPoint p(1, 2);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p);
QVERIFY(target.isPressed());
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.isPressed(), false);
QTest::mousePress(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(target.pressCount(), 2);
QTest::mouseRelease(&myWindow, Qt::LeftButton, Qt::NoModifier, p, 10);
QCOMPARE(doubleClickSpy.count(), 1);

另请参阅 QTest::mousePress() 和QTest::mouseClick()。

QTestData &QTest::newRow(const char *dataTag)

将新行追加到当前测试数据中。

测试输出将使用名称dataTag 来标识使用此测试数据的测试运行。

返回一个 QTestData 引用，可用于流式导入数据，表中的每一列对应一个值。

示例：

void MyTestClass::addSingleStringRows()
{
    QTest::addColumn<QString>("aString");
    QTest::newRow("just.hello") << QString("hello");
    QTest::newRow("a.null.string") << QString();
}

有关更详尽的示例，请参阅“数据驱动测试”。

另请参阅 addRow()、addColumn() 和QFETCH()。

int QTest::qExec(QObject *testObject, int argc = 0, char **argv = nullptr)

执行在testObject 中声明的测试。此外，如果存在私有槽initTestCase() 、cleanupTestCase() 、init() 和cleanup() ，也会执行这些槽。更多详细信息请参阅“创建测试”。

可选地，可以提供命令行参数argc 和argv 。有关可识别参数的列表，请参阅Qt Test 命令行参数。

以下示例将运行MyTestObject 中的所有测试：

MyTestObject test1;
QTest::qExec(&test1);

如果所有测试均通过，该函数返回 0；如果有一个或多个测试失败，或者发生未处理的异常，则返回非零值。（被跳过的测试不会影响返回值。）

对于独立的测试应用程序，可以使用便捷宏QTEST_MAIN() 来声明一个 main() 函数，该函数负责解析命令行参数并执行测试，从而无需显式调用此函数。

当使用QTEST_MAIN() 宏时，该函数的返回值即为测试应用程序的退出代码。

对于独立测试应用程序，不应多次调用此函数，否则用于将测试输出记录到文件以及执行单个测试函数的命令行选项将无法正常工作。

如果您是通过编程方式创建的参数（而不是从main() 中的参数获取），那么您可能会对使用 QTest::qExec(QObject *, constQStringList &) 感兴趣，因为它是 Unicode 安全的。

另请参阅 QTEST_MAIN()、QTEST_GUILESS_MAIN(）和QTEST_APPLESS_MAIN()。

int QTest::qExec(QObject *testObject, const QStringList &arguments)

其行为与 qExec(QObject *, int, char**) 完全相同，但接受一个由arguments 组成的QStringList ，而不是char** 列表。

QSharedPointer<QTemporaryDir> QTest::qExtractTestData(const QString &dirName)

将资源中的目录提取到磁盘上。内容将递归地提取到一个临时文件夹中。一旦对返回值的最后一个引用超出作用域，提取的内容将自动被删除。

dirName 是要从资源中提取的目录名称。

返回数据被提取到的临时目录，若发生错误则返回 null。

[since 6.5] void QTest::qRegisterTestCase(const QString &name, QTest::TestEntryFunction entryFunction)

将测试name （其入口函数为entryFunction ）注册到当前二进制文件的中央测试用例注册表中。

当不带任何参数运行批处理测试二进制文件时，name 将被列出。若使用name 的 argv[1] 参数运行测试二进制文件，将调用entryFunction 。

该函数于 Qt 6.5 版本中引入。

[since 6.7] void QTest::qSleep(std::chrono::milliseconds msecs)

使用 `msecs` 进行休眠，这会阻塞测试的执行。

此方法不会处理任何事件，且会导致测试进入无响应状态。休眠期间网络通信可能会超时。请使用QTest::qWait() 进行非阻塞休眠。

msecs 必须大于 0 毫秒。

示例：

using namespace std::chrono_literals;
QTest::qSleep(250ms);

该函数于 Qt 6.7 中引入。

另请参阅 QTest::qWait()。

void QTest::qSleep(int ms)

休眠ms 毫秒，阻塞测试的执行。

相当于调用：

QTest::qSleep(std::chrono::milliseconds{ms});

[since 6.7] void QTest::qWait(std::chrono::milliseconds msecs)

等待msecs 。在等待期间，系统会继续处理事件，且您的测试仍能对用户界面事件或网络通信做出响应。

示例：

    using namespace std::chrono_literals;
    int i = 0;
    while (myNetworkServerNotResponding() && i++ < 50)
        QTest::qWait(250ms);

上述代码将等待网络服务器响应，最长等待时间约为 12.5 秒。

与 qWait() 相比，QTRY_* 宏通常是更好的选择。qWait() 总是会暂停直至超时结束，这可能会导致测试处于空闲状态并减慢执行速度。

QTRY_* 宏会持续轮询该条件，直到成功或超时结束。因此，您的测试能尽快继续执行，并且更加可靠。如果条件仍然失败，这些宏会将超时时间加倍一次，并报告新值，以便您进行调整。

例如，将上面的代码重写为：

QTRY_VERIFY_WITH_TIMEOUT(!myNetworkServerNotResponding(), 12.5s);

该函数在 Qt 6.7 中引入。

另请参阅 QTest::qSleep()、QSignalSpy::wait() 和QTRY_VERIFY_WITH_TIMEOUT()。

void QTest::qWait(int msecs)

等待msecs 。相当于调用：

QTest::qWait(std::chrono::milliseconds{msecs});

[since 6.7] template <typename Functor> bool QTest::qWaitFor(Functor predicate, QDeadlineTimer deadline = QDeadlineTimer( defaultTryTimeout.load(std::memory_order_relaxed)))

等待deadline 超时，或者直到predicate 返回true，以先发生者为准。

如果predicate 在任何时候返回 true，则返回true ；否则返回false 。

示例：

    MyObject obj;
    obj.startup();
    using namespace std::chrono_literals;
    const bool result = QTest::qWaitFor([&obj]() { return obj.isReady(); },
                                        QDeadlineTimer(3s));

上述代码将等待对象就绪，最长等待三秒。

该函数自 Qt 6.7 起引入。

template <typename Functor> bool QTest::qWaitFor(Functor predicate, int timeout)

等待timeout 毫秒，或者直到predicate 返回true。

这相当于调用：

qWaitFor(predicate, QDeadlineTimer(timeout));

[since 6.10] bool QTest::qWaitForWindowActive(QWidget *widget, QDeadlineTimer timeout)

如果widget 在timeout 毫秒内处于活动状态，则返回true ；否则返回false 。

该方法在调用 `QWidget::show()` 并依赖小部件实际处于活动状态（即可见且拥有焦点）后再继续执行的测试中非常有用。

该函数在 Qt 6.10 中引入。

另请参阅 qWaitForWindowExposed() 和QWidget::isActiveWindow()。

[since 6.10] bool QTest::qWaitForWindowActive(QWindow *window, QDeadlineTimer timeout)

如果window 在timeout 内处于活动状态，则返回true ；否则返回false 。

该方法在调用 `QWindow::show()` 并依赖窗口实际处于活动状态（即可见且拥有焦点）后才继续执行的测试中非常有用。

该函数在 Qt 6.10 中引入。

另请参阅 qWaitForWindowExposed()、qWaitForWindowFocused() 和QWindow::isActive()。

[since 6.10] bool QTest::qWaitForWindowActive(QWidget *widget)

该函数使用 5 秒的默认超时时间。

该函数在 Qt 6.10 中引入。

[since 6.10] bool QTest::qWaitForWindowActive(QWindow *window)

该函数使用默认的 5 秒超时时间。

该函数在 Qt 6.10 中引入。

bool QTest::qWaitForWindowActive(QWidget *widget, int timeout)

timeout 的单位是毫秒。

bool QTest::qWaitForWindowActive(QWindow *window, int timeout)

timeout 的单位是毫秒。

[since 6.10] bool QTest::qWaitForWindowExposed(QWidget *widget, QDeadlineTimer timeout)

如果widget 在timeout 毫秒内被暴露，则返回true ；否则返回false 。

该方法在调用 `QWidget::show()` 并依赖于小部件实际可见后才继续执行的测试中非常有用。

该函数在 Qt 6.10 中引入。

另请参阅 qWaitForWindowActive()、QWidget::isVisible() 以及QWindow::isExposed()。

[since 6.10] bool QTest::qWaitForWindowExposed(QWindow *window, QDeadlineTimer timeout)

如果 `window ` 在 `timeout` 中可见，则返回 `true`；否则返回 `false`。

该方法在调用QWindow::show() 并依赖窗口实际可见性才能继续执行的测试中非常有用。

该函数在 Qt 6.10 中引入。

另请参阅 qWaitForWindowActive() 和QWindow::isExposed()。

[since 6.10] bool QTest::qWaitForWindowExposed(QWidget *widget)

该函数使用默认的 5 秒超时时间。

该函数于 Qt 6.10 中引入。

[since 6.10] bool QTest::qWaitForWindowExposed(QWindow *window)

该函数使用默认的 5 秒超时时间。

该函数在 Qt 6.10 中引入。

bool QTest::qWaitForWindowExposed(QWidget *widget, int timeout)

timeout 的单位是毫秒。

bool QTest::qWaitForWindowExposed(QWindow *window, int timeout)

timeout 的单位是毫秒。

[since 6.7] bool QTest::qWaitForWindowFocused(QWidget *widget, QDeadlineTimer timeout)

如果widget 是timeout 中的焦点窗口，则返回true ；否则返回false 。

该方法在调用 `QWidget::show()` 并依赖小部件获得焦点（例如，用于接收键盘事件）后再继续执行的测试中非常有用。

该函数于 Qt 6.7 中引入。

另请参阅 qWaitForWindowExposed()、qWaitForWindowActive() 和QGuiApplication::focusWindow()。

[since 6.7] bool QTest::qWaitForWindowFocused(QWindow *window, QDeadlineTimer timeout)

如果window 是timeout 中的焦点窗口，则返回true ；否则返回false 。

该方法在调用 `QWindow::show()` 并依赖窗口获得焦点（例如用于接收键盘事件）后再继续执行的测试中非常有用。

该函数于 Qt 6.7 中引入。

另请参阅 qWaitForWindowExposed()、qWaitForWindowActive() 和QGuiApplication::focusWindow()。

[since 6.10] bool QTest::qWaitForWindowFocused(QWidget *widget)

该函数使用 5 秒的默认超时时间。

该函数在 Qt 6.10 中引入。

[since 6.10] bool QTest::qWaitForWindowFocused(QWindow *window)

该函数使用默认的 5 秒超时时间。

该函数于 Qt 6.10 中引入。

void QTest::setBenchmarkResult(qreal result, QTest::QBenchmarkMetric metric)

将此测试函数的基准测试结果设置为result 。

若希望在不使用 QBENCHMARK 宏的情况下报告基准测试结果，请使用此函数。使用metric 来指定Qt Test 应如何解释这些结果。

结果的上下文将包括测试函数名称以及来自 _data 函数的任何数据标签。该函数在每个测试函数中只能被调用一次，后续调用将替换先前报告的结果。

请注意，对于未包含 QBENCHMARK 宏的测试函数，命令行参数 -iterations 不会产生任何影响。

[noexcept, since 6.8] void QTest::setThrowOnFail(bool enable)

启用（enable =true ）或禁用（enable=false ）在QCOMPARE()/QVERIFY() 操作失败时抛出异常（而非仅从最外层函数上下文返回）。

该功能采用引用计数机制：如果您使用true 调用了该函数N次，则需要使用false 调用N次才能回到起始位置。

当定义了QTEST_THROW_ON_FAIL C++ 宏时，此调用将无效。

该函数于 Qt 6.8 中引入。

另请参阅 setThrowOnSkip()、ThrowOnFailEnabler 、ThrowOnFailDisabler 和QTEST_THROW_ON_FAIL 。

[noexcept, since 6.8] void QTest::setThrowOnSkip(bool enable)

启用（enable =true ）或禁用（enable=false ）在调用QSKIP()时抛出异常（而非仅从最外层函数上下文中返回）。

该功能采用引用计数机制：若您在true 状态下调用此函数N次，则需在false 状态下调用该函数N次，才能回到初始状态。

当定义了QTEST_THROW_ON_SKIP C++ 宏时，此调用将无效。

该函数在 Qt 6.8 中引入。

另请参阅 setThrowOnFail()、ThrowOnSkipEnabler 、ThrowOnSkipDisabler 和QTEST_THROW_ON_SKIP 。

char *QTest::toHexRepresentation(const char *ba, qsizetype length)

返回一个字符串指针，该字符串表示字符串ba ，以空格分隔的十六进制字符序列形式呈现。如果输入被认为过长，则会进行截断。截断情况会在返回的字符串末尾通过省略号表示。调用者拥有该返回指针的所有权，并必须确保随后将其传递给 operator delete[]。

length 是字符串ba 的长度。

template <typename T> char *QTest::toString(const T &value)

返回value 的文本表示形式。该函数由QCOMPARE()调用，用于在测试失败时输出详细信息。

您可以在测试中为该函数添加特化或重载，以启用详细输出。

特化示例（Qt ≤ 5.4）：

namespace QTest {
    template<>
    char *toString(const MyPoint &point)
    {
        const QByteArray ba("MyPoint("
                            + QByteArray::number(point.x()) + ", "
                            + QByteArray::number(point.y()) + ')');
        return qstrdup(ba.data());
    }
}

上面的示例为名为MyPoint 的类定义了 toString() 的特化。每当两个MyPoint 实例的比较失败时，QCOMPARE() 都会调用此函数，将MyPoint 的内容输出到测试日志中。

同上示例，但采用重载（Qt ≥ 5.5）：

char *toString(const MyPoint &point) // should be inside the same namespace as MyPoint
{
    return QTest::toString("MyPoint(" +
                           QByteArray::number(point.x()) + ", " +
                           QByteArray::number(point.y()) + ')');
}

另请参阅 QCOMPARE()。

char *toString(QSizePolicy sp)

返回大小策略sp 的文本表示形式。

char *toString(QSizePolicy::ControlType ct)

返回控制类型ct 的文本表示形式。

char *toString(QSizePolicy::ControlTypes cts)

返回控制类型的文本表示形式：cts 。

char *toString(QSizePolicy::Policy p)

返回策略p 的文本表示形式。

char *QTest::toString(const QByteArray &ba)

返回字节数组 `ba` 的字符串表示形式。

另请参阅 QTest::toHexRepresentation()。

char *QTest::toString(const QCborError &c)

返回给定 CBOR 错误c 的文本表示形式。

char *QTest::toString(const QChar &character)

返回给定character 的文本表示形式。

char *QTest::toString(const QDate &date)

返回给定date 的文本表示形式。

char *QTest::toString(const QDateTime &dateTime)

返回由dateTime 指定的日期和时间的文本表示形式。

[since 6.5] char *QTest::toString(const QKeySequence &ks)

返回键序列ks 的文本表示。

该函数在 Qt 6.5 中引入。

char *QTest::toString(const QLatin1StringView &string)

返回给定string 的字符串表示形式。

char *QTest::toString(const QPoint &point)

返回给定point 的文本表示形式。

char *QTest::toString(const QPointF &point)

返回给定point 的文本表示形式。

char *QTest::toString(const QRect &rectangle)

返回给定rectangle 的文本表示形式。

char *QTest::toString(const QRectF &rectangle)

返回给定rectangle 的文本表示形式。

char *QTest::toString(const QSize &size)

返回给定size 的文本表示形式。

char *QTest::toString(const QSizeF &size)

返回给定size 的文本表示形式。

char *QTest::toString(const QString &string)

返回给定string 的文本表示形式。

char *QTest::toString(const QStringView &string)

返回给定string 的文本表示形式。

char *QTest::toString(const QTime &time)

返回给定time 的文本表示形式。

char *QTest::toString(const QUrl &url)

返回给定url 的文本表示形式。

char *QTest::toString(const QUuid &uuid)

返回给定uuid 的文本表示形式。

char *QTest::toString(const QVariant &variant)

返回给定variant 的文本表示形式。

char *QTest::toString(const QVector2D &v)

返回二维向量v 的字符串表示形式。

char *QTest::toString(const QVector3D &v)

返回三维向量v 的字符串表示形式。

char *QTest::toString(const QVector4D &v)

返回 4D 向量 `v` 的文本表示形式。

template <typename T1, typename T2> char *QTest::toString(const std::pair<T1, T2> &pair)

返回pair 的文本表示形式。

template <typename... Types> char *QTest::toString(const std::tuple<Types...> &tuple)

返回给定tuple 的文本表示形式。

char *QTest::toString(std::nullptr_t)

返回一个包含“nullptr ”的字符串。

QTest::QTouchEventWidgetSequence QTest::touchEvent(QWidget *widget, QPointingDevice *device, bool autoCommit = true)

为device 创建并返回一个QTouchEventSequence ，用于为widget 模拟事件。

在向序列中添加触摸事件时，widget 还将用于将提供的位置转换为屏幕坐标，除非在相应的 press()、move() 等调用中提供了另一个控件。

当QTouchEventSequence 的析构函数被调用时（即返回的对象超出作用域时），触摸事件会被提交到事件系统，除非autoCommit 被设置为 false。当autoCommit 为 false 时，必须手动调用 commit()。

createTouchDevice可调用 () 函数来创建一个用于此函数的测试触摸设备。

QTest::QTouchEventSequence QTest::touchEvent(QWindow *window, QPointingDevice *device, bool autoCommit = true)

为device 创建并返回一个QTouchEventSequence ，用于为window 模拟事件。

在向序列添加触摸事件时，window 还将用于将提供的位置转换为屏幕坐标，除非在相应的 press()、move() 等调用中提供了另一个窗口。

当QTouchEventSequence 的析构函数被调用时（即返回的对象超出作用域时），触摸事件会被提交到事件系统，除非autoCommit 被设置为 false。当autoCommit 为 false 时，必须手动调用 commit()。

createTouchDevice可调用 () 来创建一个用于此函数的测试触摸设备。

[since 6.8] void QTest::wheelEvent(QWindow *window, QPointF pos, QPoint angleDelta, QPoint pixelDelta = QPoint(0, 0), Qt::KeyboardModifiers stateKey = Qt::NoModifier, Qt::ScrollPhase phase = Qt::NoScrollPhase)

在window 内模拟一个滚轮事件，其位置为本地窗口坐标系中的pos 。angleDelta 包含滚轮的旋转角度。正值表示向前旋转，负值表示向后旋转。pixelDelta 包含屏幕上的滚动距离（以像素为单位）。该值可以为空。事件发生时的键盘状态由stateKey 指定。事件的滚动阶段由phase 指定。

该函数在 Qt 6.8 中引入。