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;

カスタム型を testdata に追加するには、Q_DECLARE_METATYPE() を使用して、QMetaType に型を登録する必要があります。

より詳細な例についてはデータ駆動型テストを参照ください。

QTest::newRow()、QFETCH()、QMetaTypeも参照 。

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

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

この関数の引数は std::snprintf() に渡され、format に従ってフォーマットされます。 注意点や制限事項については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 ウィンドウシステムインタフェースに登録されます。通常、createTouchDevice() を使用して、テストケース・クラスのメンバ変数QPointingDevice を初期化し、すべてのテストで同じインスタンスを使用し、不要になったら削除します。

QTest::QTouchEventSequence およびtouchEvent()も参照 。

const char *QTest::currentAppName()

現在実行されているバイナリの名前を返します。

const char *QTest::currentDataTag()

現在のテストデータの名前を返します。テストに割り当てられたテストデータがない場合、この関数は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 を返します。

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

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

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

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

messagePattern にマッチする警告ごとに、テストの失敗をテストログに追加します。

失敗が追加されると、テスト関数は実行を継続します。代わりにテストを中断するには、currentTestFailed() をチェックし、true であれば早めにリターンします。

各警告について、最初にマッチしたパターンが失敗となり、残りのパターンは無視される。

すべてのパターンは、各テスト関数の最後でクリアされます。

void FileTest::loadFiles()
{
    QTest::failOnWarning(QRegularExpression("^Failed to load"));

    // Each of these will cause a test failure:
    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() で作成されたメッセージは無視します。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 キーをクリックすることをシミュレートします。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)

これはオーバーロードされた関数です。

key modifier window 。 が0より大きい場合、テストはキーをクリックする前に ミリ秒待ちます。delay delay

例

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

上記の最初の例は、キーボード修飾子なしで、遅延なしで、myWindow のescape キーをクリックすることをシミュレートします。2番目の例は、shift-escape をクリックした後、myWindow を200ミリ秒遅延させたものである。

QTest::keyClicks()も参照 。

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

これはオーバーロードされた関数です。

key modifier window 。 が 0 より大きい場合、テストはキーをクリックする前に ミリ秒待つ。delay 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 で、Qt のキーイベントをwidget に送ります。オプションとして、キーボードmodifier と、イベント送信前のテストdelay (ミリ秒単位) を指定することができます。

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

これはオーバーロードされた関数です。

与えられたキーascii と関連付けられたaction で、Qt のキーイベントをwidget に送信します。オプションとして、キーボードmodifier と、イベントを送信する前のテストのdelay (ミリ秒単位) を指定することができます。

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

これはオーバーロードされた関数です。

与えられたkey と関連付けられたaction で、Qt のキーイベントをwindow に送信します。オプションで、キーボードmodifier と、イベント送信前のテストのdelay (ミリ秒単位) を指定することができます。

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

これはオーバーロードされた関数です。

与えられたキーascii と関連付けられたaction で、Qt のキーイベントをwindow に送信します。オプションで、キーボード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)

これはオーバーロードされた関数です。

key modifier widget 。 が 0 より大きい場合、キーを押す前に ミリ秒待つ。delay delay

QTest::keyRelease() およびQTest::keyClick()も参照の こと。

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

これはオーバーロードされた関数です。

key modifier window 。 が 0 より大きい場合、キーを押す前に ミリ秒待つ。delay delay

QTest::keyRelease() およびQTest::keyClick()も参照の こと。

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

これはオーバーロードされた関数です。

key modifier window 。 が 0 より大きい場合、キーを押す前に ミリ秒待つ。delay delay

QTest::keyRelease() およびQTest::keyClick()も参照の こと。

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

key modifier widget 。 が 0 より大きい場合、キーを離す前に ミリ秒待つ。delay 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)

これはオーバーロードされた関数である。

key modifier window 。 が0より大きい場合、テストはキーを解放する前に ミリ秒待つ。delay 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)

これはオーバーロードされた関数です。

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)

button modifier widgetクリックの位置は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)

これはオーバーロードされた関数です。

button stateKey windowクリックの位置は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)

button modifier widgetクリックの位置はpos で定義される。デフォルトの位置はウィジェットの中心である。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 が指定されていない場合、マウスポインタはウィジェットの中心に移動する。 (ミリ秒単位)が指定されると、マウスポインタを移動する前に待機します。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)

これはオーバーロードされた関数です。

オプションのstateKey 修飾子でwindow を指定し、マウス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)

オプションのmodifier でマウスbutton をwidget で離すことをシミュレートします。離す位置は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)

これはオーバーロードされた関数です。

オプションのstateKey 修飾子でマウスbutton をwindow で離すことをシミュレートします。離す位置は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 Command Line Arguments を参照してください。

以下の例では、MyTestObject にあるすべてのテストを実行します：

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

この関数は、テストが失敗しなかった場合は 0 を返し、1 つ以上のテストが失敗した場合や、処理されない例外が発生した場合は 0 以外の値を返します。(スキップされたテストは戻り値に影響しません)。

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

この関数の戻り値は、QTEST_MAIN （）マクロを使用した場合のテスト・アプリケーションの終了コードでもあります。

スタンドアロンのテスト・アプリケーションでは、この関数を複数回呼び出すべきではありません。テスト出力のファイルへのロギングや個々のテスト関数の実行に関するコマンドライン・オプションが正しく動作しないからです。

QTest::qExec(QObject *, constQStringList &) は Unicode セーフなので、引数をmain() の引数から取得するのではな く、プログラムで作成したのであれば、QTest::qExec( *, const &) を使用するのがよいでしょう。

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)

エントリ関数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 が真を返すか、どちらか先になるまで待ちます。

predicate がいずれかの時点で真を返した場合は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 が真を返すまで待ちます。

これは呼び出しと同じです：

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)

timeout ミリ秒以内にwidget が公開された場合はtrue を返す。そうでない場合はfalse を返す。

このメソッドは、QWidget::show() を呼び出し、処理を進める前にウィジェットが実際に表示されていることに依存するテストにおいて有用である。

qWaitForWindowActive()、QWidget::isVisible()、QWindow::isExposed()も参照のこと 。

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

timeout ミリ秒以内にwindow が表示された場合、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 マクロを使用せずにベンチマーク結果を報告したい場合は、この関数を使用します。Qt Test が結果をどのように解釈するかを指定するにはmetric を使用します。

結果のコンテキストは、テスト関数名と _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 環境変数が設定されていない限り、デフォルトはfalse です。

QTEST_THROW_ON_FAIL 環境変数が設定されていない限り、デフォルトはQTEST_THROW_ON_FAIL です。

この関数は 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 環境変数が設定されていない限り、デフォルトはfalse です。

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進数の文字列として表現された文字列へのポインタを返します。入力が長すぎると判断された場合は、切り捨てられる。切り捨ては、返される文字列の末尾に省略記号で示される。呼び出し元は返されたポインタの所有権を持ち、それが後で delete[] 演算子に渡されるようにしなければならない。

length は文字列 の長さです。ba

char *toString(QSizePolicy sp)

これはオーバーロードされた関数です。

size ポリシー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 の2つのインスタンスの比較が失敗するたびに、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)

これはオーバーロードされた関数です。

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 を含む文字列を返します。

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 のテキスト表現を返します。

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

widget のイベントをシミュレートするために、device 用のQTouchEventSequence を作成し、返します。

タッチイベントをシーケンスに追加するとき、widget は、press() や move() などの呼び出しで別のウィジェットが提供されない限り、提供された位置をスクリーン座標に変換するためにも使用される。

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

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

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

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

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

タッチイベントは、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 で導入されました。