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() のドキュメントを参照してください。

テスト出力は、このフォーマット結果の名前を使用して、このテストデータで実行されたテストを識別します。

テーブルの各列に対して 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 を返します。

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

この関数は 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 （）で作成されたメッセージは無視される。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番目の例は、shift-escape をクリックした後、myWidget を200ミリ秒遅延させたものである。

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番目の例は、shift-escape をクリックした後、myWindow を200ミリ秒遅延させたものである。

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)

sequence widget 。オプションで、キーボード 、各キーをクリックする前のテストの （ミリ秒単位）を指定できる。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)

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

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

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)

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 を、オプションのstateKey 修飾子window で指定する。クリックの位置は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 という名前を使用して、このテスト データで実行されたテストが識別されます。

テーブルの各列に 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 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)

timeout ミリ秒以内にwidget がアクティブであればtrue を返す。そうでない場合はfalse を返す。

このメソッドは、QWidget::show() を呼び出し、処理を進める前にウィジェットが実際にアクティブである (すなわち、表示されていてフォーカスがある) かどうかに依存するテストで有用です。

qWaitForWindowExposed() およびQWidget::isActiveWindow()も参照して ください。

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

timeout ミリ秒以内にwindow がアクティブな場合は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関数のデータタグになります。この関数は各試験関数で1回だけ呼び出すことができ、それ以降呼び出すと、先に報告された結果が置き換えられます。

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)

(enable =true) または ( enable =false)QSKIP() でのスローイングを有効化または無効化する ( 直後の関数コンテキストから戻るだけでなく )。

この機能は参照カウントされます：この関数を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)

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

サイズポリシーのテキスト表現を返す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)

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

policyp のテキスト表現を返します。

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 で導入されました。