QTest Namespace

Funktion Dokumentation

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

Fügt eine Spalte mit dem Typ T zu den aktuellen Testdaten hinzu. name ist der Name der Spalte. dummy ist eine Abhilfe für fehlerhafte Compiler und kann ignoriert werden.

Um die Spalte mit Werten zu füllen, kann newRow() verwendet werden. Verwenden Sie QFETCH(), um die Daten im aktuellen Test abzurufen.

Beispiel:

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

Ein ausführlicheres Beispiel finden Sie unter Datengetriebenes Testen.

Siehe auch QTest::newRow(), QFETCH(), und QMetaType.

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

Hängt eine neue Zeile an die aktuellen Testdaten an.

Die Argumente der Funktion werden an std::snprintf() zur Formatierung gemäß format übergeben. In der Dokumentation zu std::snprintf() finden Sie Hinweise und Einschränkungen.

Die Testausgabe identifiziert den Testlauf mit diesen Testdaten anhand des Namens, der sich aus dieser Formatierung ergibt.

Gibt eine QTestData-Referenz zurück, die zum Einlesen von Daten verwendet werden kann, einen Wert für jede Spalte in der Tabelle.

Beispiel:

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

Ein ausführlicheres Beispiel finden Sie unter Datengetriebenes Testen.

Siehe auch newRow(), addColumn(), und QFETCH().

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

Gibt den Enum-Wert metric als Zeichenkette zurück.

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

Gibt die Maßeinheiten für die angegebene metric zurück.

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

Erzeugt ein Dummy-Touch-Device vom Typ devType mit den Fähigkeiten caps zur Simulation von Touch-Events.

Das Touch-Gerät wird bei der Qt-Fenstersystemschnittstelle registriert. Sie sollten createTouchDevice() typischerweise verwenden, um eine QPointingDevice Membervariable in Ihrer Testfallklasse zu initialisieren, die gleiche Instanz für alle Tests zu verwenden und sie zu löschen, wenn sie nicht mehr benötigt wird.

Siehe auch QTest::QTouchEventSequence und touchEvent().

const char *QTest::currentAppName()

Gibt den Namen des Binärprogramms zurück, das gerade ausgeführt wird.

const char *QTest::currentDataTag()

Gibt den Namen der aktuellen Testdaten zurück. Wenn dem Test keine Testdaten zugeordnet sind, gibt die Funktion nullptr zurück.

bool QTest::currentTestFailed()

Gibt true zurück, wenn die aktuelle Testfunktion fehlgeschlagen ist, andernfalls false.

Siehe auch QTest::currentTestResolved().

const char *QTest::currentTestFunction()

Gibt den Namen der Testfunktion zurück, die gerade ausgeführt wird.

Beispiel:

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

[since 6.5] bool QTest::currentTestResolved()

Gibt true zurück, wenn die aktuelle Testfunktion fehlgeschlagen ist oder übersprungen wurde.

Dies gilt, wenn der Test fehlgeschlagen ist oder übersprungen wurde. Wenn es wahr ist, sollte die Testfunktion frühzeitig zurückkehren. Insbesondere die Makros QTRY_* und die Test-Ereignisschleife beenden ihre Schleifen vorzeitig, wenn sie während der Testfunktion ausgeführt werden (aber nicht deren cleanup()). Nachdem ein Test eine Hilfsfunktion aufgerufen hat, die die Makros dieses Moduls verwendet, kann er diese Funktion verwenden, um zu testen, ob er frühzeitig zurückkehren soll.

Diese Funktion wurde in Qt 6.5 eingeführt.

Siehe auch QTest::currentTestFailed().

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

Hängt für jede Warnung, die mit messagePattern übereinstimmt, einen Testfehler an das Testprotokoll an.

Die Testfunktion wird weiter ausgeführt, wenn ein Fehler hinzugefügt wird. Um den Test stattdessen abzubrechen, können Sie currentTestFailed() überprüfen und frühzeitig zurückkehren, wenn es true ist.

Bei jeder Warnung führt das erste übereinstimmende Muster zu einem Fehler, die übrigen Muster werden ignoriert.

Alle Muster werden am Ende jeder Testfunktion gelöscht.

void FileTest::loadFiles() { QTest::failOnWarning(QRegularExpression("^Failed to load")); // Jedes dieser Muster führt zu einem Fehlschlag des Tests:    qWarning() << "Failed to load image";
    qWarning() << "Failed to load video";
}

Um jeden Test, der eine bestimmte Warnung auslöst, fehlschlagen zu lassen, übergeben Sie dieser Funktion in init() einen geeigneten regulären Ausdruck:

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

Für den allgemeinen Fall, dass der Test bei jeder Warnung fehlschlägt, übergeben Sie keinen Parameter:

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

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch QTEST_FATAL_FAIL.

[since 6.8] void QTest::failOnWarning()

Diese Funktion überlastet failOnWarning().

Hängt einen Testfehler an das Testprotokoll an, wenn eine Warnung ausgegeben wird.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch failOnWarning().

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

Diese Funktion überlastet failOnWarning().

Hängt einen Testfehler an das Testprotokoll an, wenn die message ausgegeben wird.

Diese Funktion wurde in Qt 6.3 eingeführt.

Siehe auch failOnWarning().

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

Ignoriert Meldungen, die von qDebug(), qInfo() oder qWarning() erstellt wurden. Wenn die message mit der entsprechenden type ausgegeben wird, wird sie aus dem Testprotokoll entfernt. Wenn der Test beendet wurde und die message nicht ausgegeben wurde, wird ein Testfehler an das Testprotokoll angehängt.

Beispiel:

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

Das obige Beispiel testet, dass QDir::mkdir() die richtige Warnung ausgibt, wenn es mit einem ungültigen Dateinamen aufgerufen wird.

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

Dies ist eine überladene Funktion.

Ignoriert Meldungen, die von qDebug(), qInfo() oder qWarning() erzeugt wurden. Wenn die Nachricht, die messagePattern mit der entsprechenden type entspricht, ausgegeben wird, wird sie aus dem Testprotokoll entfernt. Wenn der Test beendet wurde und die Nachricht nicht ausgegeben wurde, wird ein Testfehler an das Testprotokoll angehängt.

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

Simuliert das Klicken von key mit einem optionalen modifier auf widget. Wenn delay größer als 0 ist, wartet der Test delay Millisekunden, bevor er die Taste anklickt.

Beispiele:

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

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

Das erste Beispiel oben simuliert das Klicken der Taste escape auf myWidget ohne Tastaturmodifikatoren und ohne Verzögerung. Das zweite Beispiel simuliert das Klicken von shift-escape auf myWidget nach einer Verzögerung von 200 ms des Tests.

Siehe auch QTest::keyClicks().

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

Dies ist eine überladene Funktion.

Simuliert das Klicken von key mit einem optionalen modifier auf einem widget. Wenn delay größer als 0 ist, wartet der Test delay Millisekunden, bevor die Taste geklickt wird.

Beispiel:

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

Das obige Beispiel simuliert das Klicken von a auf myWidget ohne jegliche Tastaturmodifikatoren und ohne Verzögerung des Tests.

Siehe auch QTest::keyClicks().

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

Dies ist eine überladene Funktion.

Simuliert das Klicken von key mit einem optionalen modifier auf einem window. Wenn delay größer als 0 ist, wartet der Test delay Millisekunden, bevor die Taste geklickt wird.

Beispiele:

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

Das erste Beispiel oben simuliert das Klicken der Taste escape auf myWindow ohne Tastaturmodifikatoren und ohne Verzögerung. Das zweite Beispiel simuliert das Klicken von shift-escape auf myWindow nach einer Verzögerung von 200 ms des Tests.

Siehe auch QTest::keyClicks().

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

Dies ist eine überladene Funktion.

Simuliert das Klicken von key mit einem optionalen modifier auf einem window. Wenn delay größer als 0 ist, wartet der Test delay Millisekunden, bevor die Taste geklickt wird.

Beispiel:

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

Das obige Beispiel simuliert das Klicken von a auf myWindow ohne jegliche Tastaturmodifikatoren und ohne Verzögerung des Tests.

Siehe auch QTest::keyClicks().

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

Simuliert das Klicken einer sequence von Tasten auf einer widget. Optional kann eine Tastatur modifier sowie eine delay (in Millisekunden) des Tests vor jedem Tastenklick angegeben werden.

Beispiel:

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

Das obige Beispiel simuliert das Anklicken der Tastenfolge "hello world" auf myWidget ohne jegliche Tastaturmodifikatoren und ohne Verzögerung des Tests.

Siehe auch QTest::keyClick().

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

Sendet ein Qt-Tastenereignis an widget mit dem angegebenen key und einem zugehörigen action. Optional kann eine Tastatur modifier angegeben werden, sowie ein delay (in Millisekunden) des Tests vor dem Senden des Ereignisses.

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

Dies ist eine überladene Funktion.

Sendet ein Qt-Tastenereignis an widget mit der angegebenen Taste ascii und einem zugehörigen action. Optional kann eine Tastatur modifier angegeben werden, sowie ein delay (in Millisekunden) des Tests vor dem Senden des Ereignisses.

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

Dies ist eine überladene Funktion.

Sendet ein Qt-Tastenereignis an window mit dem angegebenen key und einem zugehörigen action. Optional kann eine Tastatur modifier angegeben werden, sowie ein delay (in Millisekunden) des Tests vor dem Senden des Ereignisses.

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

Dies ist eine überladene Funktion.

Sendet ein Qt-Tastenereignis an window mit der angegebenen Taste ascii und einem zugehörigen action. Optional kann eine Tastatur modifier angegeben werden, sowie ein delay (in Millisekunden) des Tests vor dem Senden des Ereignisses.

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

Simuliert das Drücken einer key mit einer optionalen modifier auf einer widget. Wenn delay größer als 0 ist, wartet der Test auf delay Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::keyRelease() und QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert das Drücken einer key mit einer optionalen modifier auf einer widget. Wenn delay größer als 0 ist, wartet der Test für delay Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::keyRelease() und QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert das Drücken einer key mit einer optionalen modifier auf einer window. Wenn delay größer als 0 ist, wartet der Test für delay Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::keyRelease() und QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert das Drücken einer key mit einer optionalen modifier auf einer window. Wenn delay größer als 0 ist, wartet der Test für delay Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::keyRelease() und QTest::keyClick().

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

Simuliert die Freigabe eines key mit einem optionalen modifier auf einem widget. Wenn delay größer als 0 ist, wartet der Test auf delay Millisekunden, bevor er den Schlüssel freigibt.

Siehe auch QTest::keyPress() und QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert die Freigabe eines key mit einem optionalen modifier auf einem widget. Wenn delay größer als 0 ist, wartet der Test auf delay Millisekunden, bevor er den Schlüssel freigibt.

Siehe auch QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert die Freigabe eines key mit einem optionalen modifier auf einem window. Wenn delay größer als 0 ist, wartet der Test auf delay Millisekunden, bevor er den Schlüssel freigibt.

Siehe auch QTest::keyPress() und QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert die Freigabe eines key mit einem optionalen modifier auf einem window. Wenn delay größer als 0 ist, wartet der Test auf delay Millisekunden, bevor er den Schlüssel freigibt.

Siehe auch QTest::keyClick().

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

Dies ist eine überladene Funktion.

Simuliert die Eingabe von keySequence in eine widget.

Siehe auch QTest::keyClick() und QTest::keyClicks().

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

Dies ist eine überladene Funktion.

Simuliert die Eingabe von keySequence in eine window.

Siehe auch QTest::keyClick() und QTest::keyClicks().

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

Simuliert das Klicken einer Maus button mit einem optionalen modifier auf einem widget. Die Position des Klicks wird durch pos definiert; die Standardposition ist die Mitte des Widgets. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden, bevor die Taste gedrückt wird und bevor sie losgelassen wird.

Siehe auch QTest::mousePress() und QTest::mouseRelease().

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

Dies ist eine überladene Funktion.

Simuliert einen Mausklick button mit einem optionalen stateKey Modifikator auf einem window. Die Position des Klicks wird durch pos definiert; die Standardposition ist die Mitte des Fensters. Wenn delay angegeben wird, wartet der Test die angegebene Anzahl von Millisekunden, bevor die Taste gedrückt wird und bevor sie losgelassen wird.

Siehe auch QTest::mousePress() und QTest::mouseRelease().

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

Simuliert den Doppelklick einer Maus button mit einem optionalen modifier auf einem widget. Die Position des Klicks wird durch pos definiert; die Standardposition ist die Mitte des Widgets. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden vor jedem Drücken und Loslassen.

Siehe auch QTest::mouseClick().

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

Dies ist eine überladene Funktion.

Simuliert den Doppelklick einer Maus button mit einem optionalen stateKey Modifikator auf einem window. Die Position des Klicks wird durch pos definiert; die Standardposition ist die Mitte des Fensters. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden vor jedem Drücken und Loslassen.

Siehe auch QTest::mouseClick().

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

Bewegt den Mauszeiger auf eine widget. Wenn pos nicht angegeben wird, bewegt sich der Mauszeiger in die Mitte des Widgets. Wenn eine delay (in Millisekunden) angegeben wird, wartet der Test, bevor der Mauszeiger bewegt wird.

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

Dies ist eine überladene Funktion.

Bewegt den Mauszeiger auf eine window. Wenn pos nicht angegeben wird, bewegt sich der Mauszeiger in die Mitte des Fensters. Wenn eine delay (in Millisekunden) angegeben wird, wartet der Test, bevor der Mauszeiger bewegt wird.

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

Simuliert das Drücken einer Maus button mit einem optionalen modifier auf einem widget. Die Position wird durch pos definiert; die Standardposition ist die Mitte des Widgets. Wenn delay angegeben ist, wartet der Test auf die angegebene Anzahl von Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::mouseRelease() und QTest::mouseClick().

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

Dies ist eine überladene Funktion.

Simuliert das Drücken einer Maus button mit einem optionalen stateKey Modifikator auf einem window. Die Position wird durch pos definiert; die Standardposition ist die Mitte des Fensters. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden, bevor die Taste gedrückt wird.

Siehe auch QTest::mouseRelease() und QTest::mouseClick().

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

Simuliert das Loslassen einer Maus button mit einem optionalen modifier auf einem widget. Die Position des Loslassens wird durch pos definiert; die Standardposition ist die Mitte des Widgets. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden, bevor er die Taste loslässt; andernfalls wartet er eine Standardzeit (1 ms), die über Befehlszeilenargumente überschrieben werden kann.

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

Siehe auch QTest::mousePress() und QTest::mouseClick().

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

Dies ist eine überladene Funktion.

Simuliert das Loslassen einer Maustaste button mit einem optionalen stateKey Modifikator auf einem window. Die Position des Loslassens wird durch pos definiert; die Standardposition ist die Mitte des Fensters. Wenn delay angegeben ist, wartet der Test die angegebene Anzahl von Millisekunden, bevor er die Taste loslässt; andernfalls wartet er eine Standardzeit (1 ms), die über Befehlszeilenargumente überschrieben werden kann.

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

Siehe auch QTest::mousePress() und QTest::mouseClick().

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

Hängt eine neue Zeile an die aktuellen Testdaten an.

In der Testausgabe wird der Testlauf mit diesen Testdaten mit dem Namen dataTag gekennzeichnet.

Gibt eine QTestData-Referenz zurück, die zum Streamen von Daten verwendet werden kann, einen Wert für jede Spalte in der Tabelle.

Beispiel:

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

Ein ausführlicheres Beispiel finden Sie unter Datengetriebenes Testen.

Siehe auch addRow(), addColumn(), und QFETCH().

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

Führt Tests aus, die in testObject deklariert sind. Zusätzlich werden die privaten Slots initTestCase(), cleanupTestCase(), init() und cleanup() ausgeführt, falls sie existieren. Siehe Erstellen eines Tests für weitere Details.

Optional können die Befehlszeilenargumente argc und argv angegeben werden. Eine Liste der anerkannten Argumente finden Sie unter Qt Test Befehlszeilenargumente.

Im folgenden Beispiel werden alle Tests in MyTestObject ausgeführt:

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

Diese Funktion gibt 0 zurück, wenn keine Tests fehlgeschlagen sind, oder einen Wert ungleich 0, wenn ein oder mehrere Tests fehlgeschlagen sind oder wenn unbehandelte Ausnahmen aufgetreten sind. (Übersprungene Tests haben keinen Einfluss auf den Rückgabewert.)

Für eigenständige Testanwendungen kann das Makro QTEST_MAIN() verwendet werden, um eine main()-Funktion zu deklarieren, die die Befehlszeilenargumente analysiert und die Tests ausführt, so dass diese Funktion nicht explizit aufgerufen werden muss.

Der Rückgabewert dieser Funktion ist auch der Exit-Code der Testanwendung, wenn das Makro QTEST_MAIN() verwendet wird.

Bei eigenständigen Testanwendungen sollte diese Funktion nicht mehr als einmal aufgerufen werden, da sich die Befehlszeilenoptionen für die Protokollierung der Testausgabe in Dateien und die Ausführung einzelner Testfunktionen nicht korrekt verhalten.

Wenn Sie die Argumente programmatisch erstellt haben, anstatt sie von den Argumenten in main() zu erhalten, ist es wahrscheinlich von Interesse, QTest::qExec(QObject *, const QStringList &) zu verwenden, da es Unicode-sicher ist.

Siehe auch QTEST_MAIN(), QTEST_GUILESS_MAIN(), und QTEST_APPLESS_MAIN().

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

Dies ist eine überladene Funktion.

Verhält sich identisch zu qExec(QObject *, int, char**), nimmt aber eine QStringList von arguments statt einer char** Liste.

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

Extrahiert ein Verzeichnis aus den Ressourcen auf die Festplatte. Der Inhalt wird rekursiv in einen temporären Ordner extrahiert. Der extrahierte Inhalt wird automatisch entfernt, sobald der letzte Verweis auf den Rückgabewert den Anwendungsbereich verlässt.

dirName ist der Name des Verzeichnisses, das aus den Ressourcen extrahiert werden soll.

Gibt das temporäre Verzeichnis zurück, in das die Daten extrahiert wurden, oder null im Falle eines Fehlers.

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

Registriert den Test name, mit der Eingabefunktion entryFunction, in einem zentralen Testfallregister für das aktuelle Binary.

name wird aufgelistet, wenn das Batch-Test-Binary ohne Parameter ausgeführt wird. Das Ausführen des Testbinärs mit argv[1] von name führt dazu, dass entryFunction aufgerufen wird.

Diese Funktion wurde in Qt 6.5 eingeführt.

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

Schläft für msecs und blockiert die Ausführung des Tests.

Diese Methode führt keine Ereignisverarbeitung durch und lässt Ihren Test nicht reagieren. Die Netzwerkkommunikation kann während des Ruhezustands unterbrochen werden. Verwenden Sie QTest::qWait(), um eine nicht-blockierende Schlafphase durchzuführen.

msecs muss größer als 0ms sein.

Beispiel:

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

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QTest::qWait().

void QTest::qSleep(int ms)

Dies ist eine überladene Funktion.

Schläft für ms Millisekunden und blockiert die Ausführung des Tests.

Äquivalent zum Aufruf:

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

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

Wartet auf msecs. Während des Wartens werden Ereignisse verarbeitet, und Ihr Test reagiert weiterhin auf Ereignisse der Benutzeroberfläche oder Netzwerkkommunikation.

Beispiel:

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

Der obige Code wartet, bis der Netzwerkserver für maximal 12,5 Sekunden antwortet.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch QTest::qSleep() und QSignalSpy::wait().

void QTest::qWait(int msecs)

Dies ist eine überladene Funktion.

Wartet auf msecs. Äquivalent zum Aufruf:

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

[since 6.7] template <typename Functor> bool QTest::qWaitFor(Functor predicate, QDeadlineTimer deadline = QDeadlineTimer(std::chrono::seconds{5}))

Wartet, bis deadline abgelaufen ist, oder bis predicate true zurückgibt, je nachdem, was zuerst eintritt.

Gibt true zurück, wenn predicate zu irgendeinem Zeitpunkt true zurückgegeben hat, andernfalls false.

Beispiel:

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

Der obige Code wartet darauf, dass das Objekt bereit ist, maximal drei Sekunden lang.

Diese Funktion wurde in Qt 6.7 eingeführt.

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

Dies ist eine überladene Funktion.

Wartet timeout Millisekunden oder bis die predicate true zurückgibt.

Dies ist gleichbedeutend mit dem Aufruf:

qWaitFor(predicate, QDeadlineTimer(timeout));

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

Gibt true zurück, wenn widget innerhalb von timeout Millisekunden aktiv ist. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWidget::show() aufrufen und sich darauf verlassen, dass das Widget tatsächlich aktiv ist (d. h. sichtbar ist und den Fokus hat), bevor sie fortfahren.

Siehe auch qWaitForWindowExposed() und QWidget::isActiveWindow().

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

Gibt true zurück, wenn window innerhalb von timeout Millisekunden aktiv ist. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWindow::show() aufrufen und sich darauf verlassen, dass das Fenster tatsächlich aktiv ist (d. h. sichtbar ist und den Fokus hat), bevor sie fortgesetzt werden.

Siehe auch qWaitForWindowExposed(), qWaitForWindowFocused(), und QWindow::isActive().

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

Gibt true zurück, wenn widget innerhalb von timeout Millisekunden ausgesetzt wird. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWidget::show() aufrufen und sich darauf verlassen, dass das Widget tatsächlich sichtbar ist, bevor sie fortfahren.

Siehe auch qWaitForWindowActive(), QWidget::isVisible(), und QWindow::isExposed().

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

Gibt true zurück, wenn window innerhalb von timeout Millisekunden ausgesetzt wird. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWindow::show() aufrufen und sich darauf verlassen, dass das Fenster tatsächlich sichtbar ist, bevor sie fortfahren.

Siehe auch qWaitForWindowActive() und QWindow::isExposed().

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

Gibt true zurück, wenn widget das Fokusfenster innerhalb von timeout ist. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWidget::show() aufrufen und sich darauf verlassen, dass das Widget den Fokus hat (um z. B. Tastaturereignisse zu empfangen), bevor sie fortfahren.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch qWaitForWindowExposed(), qWaitForWindowActive(), und QGuiApplication::focusWindow().

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

Gibt true zurück, wenn window das Fokusfenster innerhalb von timeout ist. Andernfalls wird false zurückgegeben.

Die Methode ist nützlich in Tests, die QWindow::show() aufrufen und sich darauf verlassen, dass das Fenster den Fokus hat (um z. B. Tastaturereignisse zu empfangen), bevor sie fortfahren.

Diese Funktion wurde in Qt 6.7 eingeführt.

Siehe auch qWaitForWindowExposed(), qWaitForWindowActive(), und QGuiApplication::focusWindow().

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

Setzt das Benchmark-Ergebnis für diese Testfunktion auf result.

Verwenden Sie diese Funktion, wenn Sie Benchmark-Ergebnisse ohne Verwendung des QBENCHMARK-Makros melden möchten. Verwenden Sie metric, um anzugeben, wie Qt Test die Ergebnisse interpretieren soll.

Der Kontext für das Ergebnis ist der Name der Testfunktion und ein Daten-Tag aus der Funktion _data. Diese Funktion kann in jeder Testfunktion nur einmal aufgerufen werden, nachfolgende Aufrufe ersetzen die zuvor gemeldeten Ergebnisse.

Beachten Sie, dass das Befehlszeilenargument -iterations keine Auswirkungen auf Testfunktionen ohne das Makro QBENCHMARK hat.

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

Aktiviert (enable = true) oder deaktiviert ( enable = false) das Werfen bei QCOMPARE()/QVERIFY() Fehlschlägen (im Gegensatz zu einer einfachen Rückkehr aus dem unmittelbar umgebenden Funktionskontext).

Die Funktion ist referenzgezählt: Wenn Sie diese Funktion N-mal mit true aufrufen, müssen Sie sie N-mal mit false aufrufen, um an den Ausgangspunkt zurückzukehren.

Die Vorgabe ist false, es sei denn, die Umgebungsvariable QTEST_THROW_ON_FAIL ist gesetzt.

Dieser Aufruf hat keinen Effekt, wenn das QTEST_THROW_ON_FAIL C++ Makro definiert ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setThrowOnSkip(), ThrowOnFailEnabler, ThrowOnFailDisabler, und QTEST_THROW_ON_FAIL.

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

Aktiviert (enable = true) oder deaktiviert ( enable = false) das Werfen auf QSKIP() (im Gegensatz zu einer einfachen Rückkehr aus dem unmittelbar umgebenden Funktionskontext).

Die Funktion ist referenzgezählt: Wenn Sie diese Funktion N-mal mit true aufrufen, müssen Sie sie N-mal mit false aufrufen, um an den Ausgangspunkt zurückzukehren.

Die Vorgabe ist false, es sei denn, die Umgebungsvariable QTEST_THROW_ON_SKIP ist gesetzt.

Dieser Aufruf hat keinen Effekt, wenn das QTEST_THROW_ON_SKIP C++ Makro definiert ist.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch setThrowOnFail(), ThrowOnSkipEnabler, ThrowOnSkipDisabler, und QTEST_THROW_ON_SKIP.

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

Gibt einen Zeiger auf eine Zeichenfolge zurück, bei der es sich um die Zeichenfolge ba handelt, die als durch Leerzeichen getrennte Folge von Hex-Zeichen dargestellt wird. Wenn die Eingabe als zu lang angesehen wird, wird sie abgeschnitten. Eine Kürzung wird in der zurückgegebenen Zeichenkette durch eine Ellipse am Ende angezeigt. Der Aufrufer ist Eigentümer des zurückgegebenen Zeigers und muss sicherstellen, dass er später an den Operator delete[] übergeben wird.

length ist die Länge der Zeichenkette ba.

char *toString(QSizePolicy sp)

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der Größenrichtlinie sp zurück.

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

Gibt eine textuelle Darstellung von value zurück. Diese Funktion wird von QCOMPARE() verwendet, um im Falle eines Testfehlers ausführliche Informationen auszugeben.

Sie können Spezialisierungen oder Überladungen dieser Funktion zu Ihrem Test hinzufügen, um eine ausführliche Ausgabe zu ermöglichen.

Beispiel für Spezialisierung (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());
    }
}

Das obige Beispiel definiert eine toString()-Spezialisierung für eine Klasse namens MyPoint. Immer wenn ein Vergleich zweier Instanzen von MyPoint fehlschlägt, ruft QCOMPARE() diese Funktion auf, um den Inhalt von MyPoint in das Testprotokoll auszugeben.

Gleiches Beispiel, aber mit Überladung (Qt ≥ 5.5):

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

Siehe auch QCOMPARE().

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des 4D-Vektors v zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der pair zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen tuple zurück.

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

Dies ist eine überladene Funktion.

Gibt eine Zeichenkette zurück, die nullptr enthält.

char *toString(QSizePolicy::ControlType ct)

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des Kontrolltyps ct zurück.

char *toString(QSizePolicy::ControlTypes cts)

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der Kontrolltypen cts zurück.

char *toString(QSizePolicy::Policy p)

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der Richtlinie p zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des Byte-Arrays ba zurück.

Siehe auch QTest::toHexRepresentation().

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des angegebenen CBOR-Fehlers c zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen character zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen date zurück.

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

Dies ist eine überladene Funktion.

Gibt eine Textdarstellung des durch dateTime angegebenen Datums und der Uhrzeit zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der Tastenfolge ks zurück.

Diese Funktion wurde in Qt 6.5 eingeführt.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen string zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen point zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen point zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen rectangle zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen rectangle zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen size zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen size zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen string zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen string zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen time zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen url zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen uuid zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung der angegebenen variant zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des 2D-Vektors v zurück.

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

Dies ist eine überladene Funktion.

Gibt eine textuelle Darstellung des 3D-Vektors v zurück.

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

Erzeugt ein QTouchEventSequence für device und gibt es zurück, um Ereignisse für widget zu simulieren.

Beim Hinzufügen von Berührungsereignissen zur Sequenz wird widget auch verwendet, um die angegebene Position in Bildschirmkoordinaten zu übersetzen, sofern kein anderes Widget in den jeweiligen Aufrufen von press(), move() usw. angegeben wird.

Die Berührungsereignisse werden an das Ereignissystem übergeben, wenn der Destruktor von QTouchEventSequence aufgerufen wird (d. h. wenn das zurückgegebene Objekt den Gültigkeitsbereich verlässt), es sei denn, autoCommit ist auf false gesetzt. Wenn autoCommit false ist, muss commit() manuell aufgerufen werden.

createTouchDevice() kann aufgerufen werden, um ein Test-Touch-Gerät zur Verwendung mit dieser Funktion zu erstellen.

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

Erzeugt und gibt ein QTouchEventSequence für device zurück, um Ereignisse für window zu simulieren.

Beim Hinzufügen von Berührungsereignissen zur Sequenz wird window auch verwendet, um die angegebene Position in Bildschirmkoordinaten zu übersetzen, sofern in den jeweiligen Aufrufen von press(), move() usw. kein anderes Fenster angegeben wird.

Die Berührungsereignisse werden an das Ereignissystem übergeben, wenn der Destruktor von QTouchEventSequence aufgerufen wird (d. h. wenn das zurückgegebene Objekt den Gültigkeitsbereich verlässt), es sei denn, autoCommit ist auf false gesetzt. Wenn autoCommit false ist, muss commit() manuell aufgerufen werden.

createTouchDevice() kann aufgerufen werden, um ein Test-Touch-Gerät zur Verwendung mit dieser Funktion zu erstellen.

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

Simuliert ein Radereignis innerhalb von window an der Position pos in lokalen Fensterkoordinaten. angleDelta enthält den Drehwinkel des Rads. Ein positiver Wert bedeutet Vorwärtsdrehung, ein negativer Wert bedeutet Rückwärtsdrehung. pixelDelta enthält den Bildlaufabstand in Pixeln auf dem Bildschirm. Dieser Wert kann Null sein. Die Tastaturzustände zum Zeitpunkt des Ereignisses werden durch stateKey angegeben. Die Scrolling-Phase des Ereignisses wird durch phase spezifiziert.

Diese Funktion wurde in Qt 6.8 eingeführt.