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()

返回当前测试数据的名称。如果测试没有分配任何 testdata，函数将返回nullptr 。

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 。

这适用于测试失败或跳过的情况。为真时，测试函数应提前返回。尤其是QTRY_* 宏和测试事件循环，如果在测试函数期间执行（但不包括其清理()），则应提前终止其循环。测试调用了使用该模块宏的辅助函数后，可以使用该函数来测试是否提前返回。

此函数在 Qt 6.5 中引入。

另请参阅 QTest::currentTestFailed()。

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

对符合messagePattern 的每个警告，将测试失败附加到测试日志中。

添加失败后，测试函数将继续执行。要终止测试，可以检查currentTestFailed() 并在true 时提前返回。

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

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

voidFileTest::loadFiles() {QTest::failOnWarning(QRegularExpression("^Failed to load"));// 每种模式都会导致测试失败：    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()

该函数重载了 failOnWarning()。

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

此函数在 Qt 6.8 中引入。

另请参阅 failOnWarning()。

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

该函数重载了 failOnWarning()。

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

此函数在 Qt 6.3 中引入。

另请参阅 failOnWarning().

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

忽略由qDebug(),qInfo() 或qWarning() 创建的信息。如果message 与相应的type 一起输出，则会从测试日志中删除。如果测试结束后没有输出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)

模拟在widget 上点击key 和可选的modifier 。如果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)

这是一个重载函数。

使用可选的modifier 在widget 上模拟点击key 。如果delay 大于 0，测试将等待delay 毫秒后再点击按键。

举例说明：

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

上面的示例模拟了在myWidget 上点击a ，没有任何键盘修饰符，测试也没有延迟。

另请参阅 QTest::keyClicks() 。

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

这是一个重载函数。

使用可选的modifier 在window 上模拟点击key 。如果delay 大于 0，测试将等待delay 毫秒后再点击按键。

示例

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

上面的第一个示例模拟在myWindow 上点击escape 键，没有任何键盘修饰符，也没有延迟。第二个示例模拟在测试延迟 200 毫秒后点击myWindow 上的shift-escape 。

另请参阅 QTest::keyClicks().

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

这是一个重载函数。

使用可选的modifier 在window 上模拟点击key 。如果delay 大于 0，测试将等待delay 毫秒后再点击按键。

举例说明：

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

上面的示例模拟了在myWindow 上点击a ，没有任何键盘修饰符，测试也没有延迟。

另请参阅 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)

通过给定的key 和相关的action 向widget 发送 Qt XML 按键事件。可选择指定键盘modifier ，以及发送事件前的测试时间delay （以毫秒为单位）。

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

这是一个重载函数。

通过给定的按键ascii 和关联的action 向widget 发送 Qt XML 按键事件。可选择指定键盘modifier ，以及发送事件前的测试时间delay （以毫秒为单位）。

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

这是一个重载函数。

通过给定的key 和关联的action 向window 发送 Qt XML 按键事件。可选择指定键盘modifier ，以及发送事件前的测试时间delay （以毫秒为单位）。

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

这是一个重载函数。

通过给定的按键ascii 和关联的action 向window 发送 Qt XML 按键事件。可选择指定键盘modifier ，以及发送事件前的测试时间delay （以毫秒为单位）。

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

模拟在widget 上按key ，可选择按modifier 。如果delay 大于 0，测试将等待delay 毫秒后再按键。

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

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

这是一个重载函数。

模拟在widget 上按下key 和可选的modifier 。如果delay 大于 0，测试将等待delay 毫秒后再按键。

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

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

这是一个重载函数。

模拟在window 上按下key 和可选的modifier 。如果delay 大于 0，测试将等待delay 毫秒后再按键。

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

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

这是一个重载函数。

模拟在window 上按下key 和可选的modifier 。如果delay 大于 0，测试将等待delay 毫秒后再按键。

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

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

模拟在widget 上通过可选的modifier 释放key 。如果delay 大于 0，测试将等待delay 毫秒后再释放密钥。

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

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

这是一个重载函数。

模拟在widget 上通过可选的modifier 释放key 。如果delay 大于 0，测试将等待delay 毫秒后再释放密钥。

另请参阅 QTest::keyClick() 。

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

这是一个重载函数。

模拟在window 上通过可选的modifier 释放key 。如果delay 大于 0，测试将等待delay 毫秒后才释放密钥。

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

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

这是一个重载函数。

模拟在window 上通过可选的modifier 释放key 。如果delay 大于 0，测试将等待delay 毫秒后再释放密钥。

另请参阅 QTest::keyClick() 。

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

这是一个重载函数。

模拟将keySequence 键入widget 。

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

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

这是一个重载函数。

模拟将keySequence 键入window 。

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

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

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

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

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

这是一个重载函数。

模拟点击鼠标button ，可在window 上选择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 定义；默认位置是 widget 的中心。如果指定了delay ，测试将在每次按下和松开前等待指定的毫秒数。

另请参阅 QTest::mouseClick() 。

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

这是一个重载函数。

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

另请参阅 QTest::mouseClick() 。

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

将鼠标指针移动到widget 。如果未指定pos ，鼠标指针将移动到 widget 的中心。如果给出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 上通过可选的modifier 按鼠标button 。位置由pos 定义；默认位置是 widget 的中心。如果指定了delay ，测试将在按下之前等待指定的毫秒数。

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

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

这是一个重载函数。

模拟按下鼠标button ，可在window 上选择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 上通过可选的modifier 释放鼠标button 。释放的位置由pos 定义；默认位置是 widget 的中心。如果指定了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)

这是一个重载函数。

模拟释放鼠标button ，在window 上使用可选的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；如果一个或多个测试失败，或出现未处理的异常，该函数将返回 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 是要从资源中提取的目录名称。

返回提取数据的临时目录，如果出错则返回空值。

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

在当前二进制文件的中央测试用例注册表中注册具有入口函数entryFunction 的测试name 。

运行不带参数的批量测试二进制文件时，将列出name 。使用name 的 argv[1] 运行测试二进制文件时，将调用entryFunction 。

此函数在 Qt 6.5 中引入。

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

msecs睡眠，阻塞测试的执行。

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

msecs 必须大于 0ms。

举例说明：

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 秒。

此函数在 Qt 6.7 中引入。

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

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(std::chrono::seconds{5}))

等待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));

上面的代码将等待对象就绪，等待时间最长为 3 秒。

此函数在 Qt 6.7 中引入。

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

这是一个重载函数。

等待timeout 毫秒或predicate 返回 true。

这相当于调用

qWaitFor(predicate, QDeadlineTimer(timeout));

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

如果widget 在timeout 毫秒内激活，则返回true 。否则返回false 。

该方法适用于调用QWidget::show() 并依赖窗口小部件实际处于活动状态（即可见和有焦点）才继续进行的测试。

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

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

如果window 在timeout 毫秒内激活，则返回true 。否则返回false 。

该方法适用于调用QWindow::show() 并依赖窗口实际处于活动状态（即可见且有焦点）才能继续的测试。

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

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

如果widget 在timeout 毫秒内曝光，则返回true 。否则返回false 。

该方法适用于调用QWidget::show() 并依赖窗口小部件实际可见才继续进行的测试。

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

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

如果window 在timeout 毫秒内曝光，则返回true 。否则返回false 。

该方法适用于调用QWindow::show() 并依赖窗口实际可见才继续的测试。

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

[since 6.7] bool QTest::qWaitForWindowFocused(QWidget *widget, QDeadlineTimer timeout = std::chrono::seconds{5})

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

该方法适用于调用QWidget::show() 并依赖窗口小部件具有焦点（如接收键盘事件）才能继续的测试。

此函数在 Qt 6.7 中引入。

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

[since 6.7] bool QTest::qWaitForWindowFocused(QWindow *window, QDeadlineTimer timeout = std::chrono::seconds{5})

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

该方法适用于调用QWindow::show() 并依赖窗口有焦点（如接收键盘事件）才能继续的测试。

此函数在 Qt 6.7 中引入。

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

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

将此测试功能的基准结果设置为result 。

如果要报告基准结果而不使用 QBENCHMARK 宏，请使用此函数。使用metric 指定Qt Test 应如何解释结果。

结果的上下文将是测试函数名称和来自 _data 函数的任何数据标记。该函数在每个测试函数中只能调用一次，后续调用将替换之前报告的结果。

请注意，命令行参数 -iterations 对不含 QBENCHMARK 宏的测试函数没有影响。

[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 的指针，该字符串以空格分隔的十六进制字符序列表示。如果输入内容过长，会被截断。截断会在返回字符串的末尾用省略号表示。调用者拥有返回指针的所有权，必须确保随后将其传递给操作符 delete[]。

length 是字符串的长度 。ba

char *toString(QSizePolicy sp)

这是一个重载函数。

返回尺寸策略的文本表示sp 。

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）：

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

另请参见 QCOMPARE()。

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 的字符串。

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 。

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 中引入。