QEventLoop Class

Dokumentation der Mitgliedsfunktionen

[explicit] QEventLoop::QEventLoop(QObject *parent = nullptr)

Konstruiert ein Ereignisschleifenobjekt mit der angegebenen parent.

[virtual noexcept] QEventLoop::~QEventLoop()

Zerstört das Objekt der Ereignisschleife.

[override virtual] bool QEventLoop::event(QEvent *event)

Reimplements: QObject::event(QEvent *e).

int QEventLoop::exec(QEventLoop::ProcessEventsFlags flags = AllEvents)

Tritt in die Hauptereignisschleife ein und wartet, bis exit() aufgerufen wird. Gibt den Wert zurück, der an exit() übergeben wurde.

Wenn flags angegeben ist, werden nur Ereignisse der von flags zugelassenen Typen verarbeitet.

Es ist notwendig, diese Funktion aufzurufen, um die Ereignisbehandlung zu starten. Die Hauptereignisschleife empfängt Ereignisse vom Fenstersystem und gibt diese an die Anwendungs-Widgets weiter.

Im Allgemeinen kann vor dem Aufruf von exec() keine Benutzerinteraktion stattfinden. Als Sonderfall können modale Widgets wie QMessageBox vor dem Aufruf von exec() verwendet werden, da modale Widgets ihre eigene lokale Ereignisschleife verwenden.

Um Ihre Anwendung eine Leerlaufverarbeitung durchführen zu lassen (d.h. eine spezielle Funktion auszuführen, wenn keine Ereignisse anstehen), verwenden Sie QChronoTimer mit 0ns Timeout. Anspruchsvollere Leerlaufverarbeitungsschemata können mit processEvents() erreicht werden.

Siehe auch QCoreApplication::quit(), exit(), und processEvents().

[slot] void QEventLoop::exit(int returnCode = 0)

Weist die Ereignisschleife an, sich mit einem Rückgabewert zu beenden.

Nachdem diese Funktion aufgerufen wurde, kehrt die Ereignisschleife vom Aufruf von exec() zurück. Die Funktion exec() gibt returnCode zurück.

Gemäß der Konvention bedeutet ein returnCode von 0 Erfolg, und jeder Wert ungleich Null bedeutet einen Fehler.

Beachten Sie, dass diese Funktion im Gegensatz zur gleichnamigen C-Bibliotheksfunktion an den Aufrufer zurückkehrt - die Ereignisverarbeitung wird angehalten.

Siehe auch QCoreApplication::quit(), quit(), und exec().

bool QEventLoop::isRunning() const

Gibt true zurück, wenn die Ereignisschleife läuft; andernfalls wird false zurückgegeben. Die Ereignisschleife wird ab dem Zeitpunkt des Aufrufs von exec() bis zum Aufruf von exit() als laufend betrachtet.

Siehe auch exec() und exit().

bool QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags = AllEvents)

Verarbeitet einige ausstehende Ereignisse, die flags entsprechen. Gibt true zurück, wenn anstehende Ereignisse bearbeitet wurden; andernfalls false.

Diese Funktion ist besonders nützlich, wenn Sie eine lange laufende Operation haben und deren Fortschritt anzeigen wollen, ohne Benutzereingaben zuzulassen, d.h. mit dem ExcludeUserInputEvents Flag.

Diese Funktion ist einfach ein Wrapper für QAbstractEventDispatcher::processEvents(). Einzelheiten finden Sie in der Dokumentation dieser Funktion.

[since 6.7] void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)

Verarbeitet ausstehende Ereignisse, die mit flags übereinstimmen, bis deadline abgelaufen ist oder bis es keine weiteren Ereignisse mehr zu verarbeiten gibt, je nachdem, was zuerst eintritt. Diese Funktion ist besonders nützlich, wenn Sie eine lang laufende Operation haben und deren Fortschritt anzeigen möchten, ohne dass Benutzereingaben möglich sind, d. h. mit dem Flag ExcludeUserInputEvents.

Hinweise:

• Diese Funktion verarbeitet Ereignisse nicht kontinuierlich; sie kehrt zurück, nachdem alle verfügbaren Ereignisse verarbeitet wurden.
• Die Angabe des Flags WaitForMoreEvents macht keinen Sinn und wird ignoriert.

Diese Funktion wurde in Qt 6.7 eingeführt.

void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, int maxTime)

Dies ist eine überladene Funktion.

Verarbeitet anstehende Ereignisse, die mit flags übereinstimmen, für maximal maxTime Millisekunden oder bis keine weiteren Ereignisse mehr zu verarbeiten sind, je nachdem, was kürzer ist.

Äquivalent zum Aufruf von:

processEvents(flags, QDeadlineTimer(maxTime));

[slot] void QEventLoop::quit()

Sagt der Ereignisschleife, dass sie normal beendet werden soll.

Dasselbe wie exit(0).

Siehe auch QCoreApplication::quit() und exit().

void QEventLoop::wakeUp()

Weckt die Ereignisschleife auf.

Siehe auch QAbstractEventDispatcher::wakeUp().