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, ...)

現在のテストデータに新しい行を追加します。

この関数の引数は、format に準拠した書式設定を行うために std::snprintf() に渡されます。注意事項や制限事項については、std::snprintf() のドキュメントを参照してください。

テスト出力では、このフォーマット処理の結果として得られる名前を使用して、このテストデータによるテスト実行を識別します。

テーブルの各列ごとに1つの値として、データをストリームで読み込むために使用できる 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)

タッチイベントのシミュレーションを行うため、機能caps を持つ、devType 型のダミータッチデバイスを作成します。

このタッチデバイスは、Qtウィンドウシステムインターフェースに登録されます。通常は、テストケースクラス内でQPointingDevice メンバー変数を初期化するためにcreateTouchDevice()を使用し、すべてのテストで同じインスタンスを使用し、不要になった時点でそれを削除する必要があります。

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 を返します。

これは、テストが失敗した場合、またはスキップが実行された場合に適用されます。この値が true の場合、テスト関数は早期に終了する必要があります。 特に、QTRY_* マクロおよびテストイベントループは、テスト関数内（ただし cleanup() 内を除く）で実行された場合、ループを早期に終了します。テストが本モジュールのマクロを使用するヘルパー関数を呼び出した後、この関数を使用して早期に戻るべきかどうかを判断できます。

この関数は Qt 6.5 で導入されました。

QTest::currentTestFailed()も参照してください 。

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

messagePattern に一致する警告ごとに、テストログにテスト失敗を1件追加します。

テスト関数は、失敗が追加されても実行を継続します。代わりにテストを中止するには、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)

widget 上で、オプションのmodifier を指定して、key のクリックをシミュレートします。delay が0より大きい場合、テストはdelay ミリ秒待機してからキーをクリックします。

例：

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

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

上記の最初の例は、myWidget で、キーボードの修飾キーを使用せず、遅延も設けずにescape キーをクリックすることをシミュレートします。2番目の例は、テストを200ミリ秒遅延させた後、myWidget でshift-escape をクリックすることをシミュレートします。

QTest::keyClicks()も参照してください 。

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

widget 上で、オプションのmodifier を指定して、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)

window 上で、オプションのmodifier を指定して、key のクリックをシミュレートします。delay が0より大きい場合、テストはdelay ミリ秒待機してからキーをクリックします。

例：

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

上記の最初の例は、キーボード修飾キーを使用せず、遅延も設けずに、myWindow でescape キーをクリックすることをシミュレートします。2番目の例は、テストが200 ms遅延した後、myWindow でshift-escape をクリックすることをシミュレートします。

QTest::keyClicks()も参照してください 。

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

window 上で、オプションのmodifier を指定して、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キーイベントを送信します。オプションで、キーボードmodifier を指定できるほか、イベントを送信する前のテストのdelay （ミリ秒単位）も指定できます。

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

指定されたキーascii と、それに関連付けられたaction を用いて、widget にQtキーイベントを送信します。オプションで、キーボード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キーイベントを送信します。オプションで、キーボードのmodifier を指定できるほか、イベントを送信する前のテストのdelay （ミリ秒単位）を指定することもできます。

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

指定されたキーascii および関連付けられたaction を使用して、window にQtキーイベントを送信します。オプションで、キーボードmodifier を指定できるほか、イベントを送信する前のテストのdelay （ミリ秒単位）を指定することもできます。

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

widget 上で、オプションのmodifier を指定してkey の押下をシミュレートします。delay が0より大きい場合、テストはdelay ミリ秒待機してからキーを押下します。

QTest::keyRelease() およびQTest::keyClick()も参照してください 。

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

widget 上で、オプションのmodifier を指定してkey が押されたことをシミュレートします。delay が0より大きい場合、テストはdelay ミリ秒待機してからキーを押します。

QTest::keyRelease() およびQTest::keyClick()も参照してください 。

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

window 上で、オプションのmodifier を指定してkey を押下したことをシミュレートします。delay が0より大きい場合、テストはdelay ミリ秒待機してからキーを押下します。

QTest::keyRelease() およびQTest::keyClick()も参照してください 。

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

window 上で、オプションの `modifier ` を使用して、key を押下した状態をシミュレートします。`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)

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 上で、オプションのmodifier を指定して、button のマウスクリックをシミュレートします。クリック位置は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 上で、オプションのstateKey 修飾子付きで、マウスクリックbutton をシミュレートします。クリック位置は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 上で、オプションのmodifier を指定して、button へのマウスダブルクリックをシミュレートします。クリック位置はpos で定義され、デフォルトの位置はウィジェットの中心です。delay が指定されている場合、テストは各クリックと離しの前に、指定されたミリ秒数だけ待機します。

QTest::mouseClick()も参照してください 。

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

window 上で、オプションのstateKey 修飾子付きで、マウスbutton のダブルクリックをシミュレートします。クリック位置は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 上で、オプションのmodifier を指定して、マウスbutton のクリックをシミュレートします。位置は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 上で、オプションでstateKey 修飾キーを指定して、マウスボタンbutton を押下したことをシミュレートします。位置は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 で定義され、デフォルトの位置はウィジェットの中心です。delay が指定された場合、テストは指定されたミリ秒数だけ待機してからボタンを離します。指定がない場合は、デフォルトの時間（1 ms）待機しますが、これはコマンドライン引数で上書き可能です。

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 上で、オプションのstateKey 修飾子付きで、マウスbutton のボタンを離すことをシミュレートします。ボタンを離す位置はpos で定義されます。デフォルトの位置はウィンドウの中心です。delay が指定された場合、テストは指定されたミリ秒数だけ待機してからボタンを離します。指定がない場合は、デフォルトの時間（1 ms）待機しますが、これはコマンドライン引数で上書き可能です。

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 」という名前で識別されます。

テーブルの各列ごとに 1 つの値としてデータをストリーム入力するために使用できる 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 を返し、1 つ以上のテストが失敗した場合や未処理の例外が発生した場合は 0 以外の値を返します。（スキップされたテストは戻り値に影響しません。）

スタンドアロンのテストアプリケーションの場合、便利なマクロ `QTEST_MAIN()` を使用することで、コマンドライン引数を解析してテストを実行する `main()` 関数を宣言でき、この関数を明示的に呼び出す必要がなくなります。

QTEST_MAIN() マクロを使用する場合、この関数の戻り値はテストアプリケーションの終了コードにもなります。

スタンドアロンのテストアプリケーションの場合、テスト出力をファイルに記録したり、個々のテスト関数を実行したりするためのコマンドラインオプションが正しく動作しなくなるため、この関数を 2 回以上呼び出してはなりません。

main() の引数から取得するのではなく、プログラムで引数を作成した場合は、Unicode に対応している QTest::qExec(QObject *, constQStringList &) を使用するとよいでしょう。

QTEST_MAIN()、QTEST_GUILESS_MAIN()、およびQTEST_APPLESS_MAIN()も参照してください 。

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

qExec(QObject *, int, char**) とまったく同じように動作しますが、char** のリストの代わりに、arguments のQStringList を受け取ります。

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 は 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秒間待機します。

QTRY_* マクロは、通常 qWait() よりも適しています。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));

上記のコードは、オブジェクトの準備が整うまで、最大3秒間待機します。

この関数は 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)

timeout 内でwindow がアクティブな場合、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)

timeout 内でwindow が公開されている場合は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関数からのデータタグとなります。この関数は各テスト関数内で1回のみ呼び出すことができ、それ以降の呼び出しでは以前に報告された結果が上書きされます。

なお、-iterations コマンドライン引数は、QBENCHMARK マクロを使用していないテスト関数には影響を与えません。

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

QCOMPARE() やQVERIFY() の失敗時に例外をスローするように有効化（enable =true ）または無効化（enable =false ）します（直近の関数コンテキストから単に返るだけとは対照的です）。

この機能は参照カウント方式を採用しています。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)

QSKIP() の実行時に例外をスローするように有効化（enable =true ）または無効化（enable =false ）します（直近の関数コンテキストから単に返るだけの場合とは対照的です）。

この機能は参照カウント方式を採用しています。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 ` を、スペースで区切られた16進文字のシーケンスとして表した文字列へのポインタを返します。入力が長すぎると判断された場合は、切り捨てられます。切り捨てられた場合は、返される文字列の末尾に省略記号（…）で示されます。呼び出し元は、返されたポインタの所有権を持ち、後で `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 の2つのインスタンスの比較が失敗した場合、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)

2次元ベクトル `v` の文字列表現を返します。

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

3Dベクトル `v` の文字列表現を返します。

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

4次元ベクトル `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 に対して、widget のイベントをシミュレートするためのQTouchEventSequence を作成して返します。

シーケンスにタッチイベントを追加する際、press() や move() などの各呼び出しで別のウィジェットが指定されていない限り、widget を使用して、指定された位置を画面座標に変換します。

autoCommit autoCommit がfalseに設定されていない限り、 のデストラクタが呼び出されたとき（つまり、返されたオブジェクトのスコープが終了したとき）、タッチイベントはイベントシステムにコミットされます。 がfalseの場合、commit()を手動で呼び出す必要があります。QTouchEventSequence

createTouchDevice() を呼び出すことで、この関数で使用するためのテスト用タッチデバイスを作成できます。

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

device 用のQTouchEventSequence を作成して返し、window のイベントをシミュレートします。

シーケンスにタッチイベントを追加する際、press() や move() などの呼び出しで別のウィンドウが指定されていない限り、window を使用して、指定された位置を画面座標に変換します。

autoCommit がfalseに設定されていない限り、QTouchEventSequence のデストラクタが呼び出されたとき（つまり、返されたオブジェクトがスコープ外になったとき）、タッチイベントはイベントシステムにコミットされます。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 には、画面上のスクロール距離（ピクセル単位）が格納されます。この値はnullでも構いません。イベント発生時のキーボードの状態は、stateKey で指定されます。イベントのスクロールフェーズは、phase で指定されます。

この関数は Qt 6.8 で導入されました。