QSignalSpy Class

Dokumentation der Mitgliedsfunktionen

template <typename PointerToMemberFunction> QSignalSpy::QSignalSpy(const QObject *object, PointerToMemberFunction signal)

Erstellt einen neuen `QSignalSpy`, der auf die Aussendung des Signals ` signal ` von der Klasse ` QObject ` ( object) wartet. Wenn der `QSignalSpy` kein gültiges Signal empfangen kann (beispielsweise weil ` object ` den Wert ` nullptr ` hat oder ` signal ` kein gültiges Signal von ` object` bezeichnet), wird mithilfe von ` qWarning()` eine erläuternde Warnmeldung ausgegeben, und nachfolgende Aufrufe von ` isValid() ` geben `false` zurück.

Beispiel:

QSignalSpy spy(myPushButton, &QPushButton::clicked);

QSignalSpy::QSignalSpy(const QObject *obj, QMetaMethod signal)

Erstellt einen neuen `QSignalSpy`, der auf die Aussendung des Signals „ signal “ durch das Objekt ` QObject ` ( obj) wartet. Wenn der `QSignalSpy` kein gültiges Signal abhören kann (beispielsweise weil ` obj ` den Wert ` nullptr ` hat oder ` signal ` kein gültiges Signal von ` obj` bezeichnet), wird über ` qWarning()` eine erklärende Warnmeldung ausgegeben, und nachfolgende Aufrufe von ` isValid() ` geben „false“ zurück.

Dieser Konstruktor ist praktisch, wenn das Metaobjektsystem von Qt in einem Test intensiv genutzt wird.

Einfaches Anwendungsbeispiel:

QObject object;
auto mo = object.metaObject();
auto signalIndex = mo->indexOfSignal("objectNameChanged(QString)");
auto signal = mo->method(signalIndex);

QSignalSpy spy(&object, signal);
object.setObjectName("A new object name");
QCOMPARE(spy.count(), 1);

Angenommen, wir müssen prüfen, ob alle Eigenschaften der Klasse „ QWindow “, die die minimalen und maximalen Abmessungen darstellen, ordnungsgemäß beschreibbar sind. Das folgende Beispiel veranschaulicht einen der Ansätze:

void tst_QWindow::writeMinMaxDimensionalProps_data()
    QTest::addColumn<int>("propertyIndex");

    // Collect all relevant properties
    static const auto mo = QWindow::staticMetaObject;
    for (int i = mo.propertyOffset(); i < mo.propertyCount(); ++i) {
        auto property = mo.property(i);

        // ...that have type int
        if (property.type() == QVariant::Int) {
            static const QRegularExpression re("^minimum|maximum");
            const auto name = property.name();

            // ...and start with "minimum" or "maximum"
            if (re.match(name).hasMatch()) {
                QTest::addRow("%s", name) << i;
            }
        }
    }
}

void tst_QWindow::writeMinMaxDimensionalProps()
{
    QFETCH(int, propertyIndex);

    auto property = QWindow::staticMetaObject.property(propertyIndex);
    QVERIFY(property.isWritable());
    QVERIFY(property.hasNotifySignal());

    QWindow window;
    QSignalSpy spy(&window, property.notifySignal());

    QVERIFY(property.write(&window, 42));
    QCOMPARE(spy.count(), 1);
}

[explicit] QSignalSpy::QSignalSpy(const QObject *object, const char *signal)

Erstellt einen neuen `QSignalSpy`, der auf die Aussendung des Signals ` signal ` von ` QObject ` object wartet. Wenn `QSignalSpy` kein gültiges Signal empfangen kann (beispielsweise weil ` object ` auf ` nullptr ` verweist oder ` signal ` kein gültiges Signal von ` object` bezeichnet), wird mithilfe von ` qWarning()` eine erläuternde Warnmeldung ausgegeben, und nachfolgende Aufrufe von ` isValid() ` geben `false` zurück.

Beispiel:

QSignalSpy spy(myPushButton, SIGNAL(clicked(bool)));

[noexcept] QSignalSpy::~QSignalSpy()

Destruktor.

[noexcept] bool QSignalSpy::isValid() const

Gibt „ true “ zurück, wenn der Signal-Spy ein gültiges Signal überwacht, andernfalls „false“.

QByteArray QSignalSpy::signal() const

Gibt das normalisierte Signal zurück, das der „Spy“ gerade abhört.

bool QSignalSpy::wait(int timeout)

Dies ist eine überladene Funktion, die der Übergabe von ` timeout ` an die `chrono`-Überladung entspricht:

wait(std::chrono::milliseconds{timeout});

Gibt „ true “ zurück, wenn das Signal mindestens einmal in „ timeout “ ausgelöst wurde, andernfalls „ false “.

[since 6.6] bool QSignalSpy::wait(std::chrono::milliseconds timeout = std::chrono::seconds{5})

Startet eine Ereignisschleife, die so lange läuft, bis das angegebene Signal empfangen wird oder die Zeit „ timeout “ abgelaufen ist – je nachdem, was zuerst eintritt.

timeout ist ein beliebiger gültiger Wert vom Typ `std::chrono::duration` (z. B. `std::chrono::seconds`, `std::chrono::milliseconds` usw.).

Gibt ` true ` zurück, wenn das Signal mindestens einmal innerhalb von ` timeout` ausgelöst wurde, andernfalls ` false`.

Beispiel:

using namespace std::chrono_literals;
QSignalSpy spy(object, signal);
spy.wait(2s);

Diese Funktion wurde in Qt 6.6 eingeführt.