QSignalSpy Class

Dokumentation der Mitgliedsfunktionen

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

Konstruiert einen neuen QSignalSpy, der auf Aussendungen des signal von QObject object lauscht. Wenn QSignalSpy nicht in der Lage ist, nach einem gültigen Signal zu lauschen (z.B. weil object nullptr ist oder signal kein gültiges Signal von object bezeichnet), wird eine erklärende Warnmeldung mit qWarning() ausgegeben und nachfolgende Aufrufe von isValid() geben false zurück.

Beispiel:

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

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

Konstruiert einen neuen QSignalSpy, der auf Aussendungen des signal von QObject obj lauscht. Wenn QSignalSpy nicht in der Lage ist, auf ein gültiges Signal zu lauschen (zum Beispiel, weil obj nullptr ist oder signal kein gültiges Signal von obj bezeichnet), wird eine erklärende Warnmeldung mit qWarning() ausgegeben und nachfolgende Aufrufe von isValid() geben false zurück.

Dieser Konstruktor ist praktisch, wenn das Meta-Objektsystem von Qt in einem Test stark 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);

Stellen Sie sich vor, Sie müssen überprüfen, ob alle Eigenschaften der Klasse QWindow, die die minimalen und maximalen Abmessungen repräsentieren, ordnungsgemäß beschreibbar sind. Das folgende Beispiel demonstriert 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)

Konstruiert einen neuen QSignalSpy, der auf Aussendungen des signal von QObject object lauscht. Wenn QSignalSpy nicht in der Lage ist, nach einem gültigen Signal zu lauschen (z.B. weil object nullptr ist oder signal kein gültiges Signal von object bezeichnet), wird eine erklärende Warnmeldung mit qWarning() ausgegeben und nachfolgende Aufrufe von isValid() geben false zurück.

Beispiel:

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

[noexcept] QSignalSpy::~QSignalSpy()

Zerstörer.

[noexcept] bool QSignalSpy::isValid() const

Gibt true zurück, wenn der Signalspion auf ein gültiges Signal hört, andernfalls false.

QByteArray QSignalSpy::signal() const

Gibt das normalisierte Signal zurück, dem der Spion gerade lauscht.

bool QSignalSpy::wait(int timeout)

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

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

Gibt true zurück, wenn das Signal mindestens einmal in timeout ausgesendet 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 timeout abgelaufen ist, je nachdem, was zuerst eintritt.

timeout ist eine beliebige gültige std::chrono::duration (std::chrono::seconds, std::chrono::milliseconds ...etc).

Gibt true zurück, wenn das Signal mindestens einmal in timeout ausgesendet 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.