QAbstractEventDispatcher Class

Dokumentation der Member-Funktionen

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

Erstellt einen neuen Event-Dispatcher mit dem angegebenen „ parent “.

[virtual noexcept] QAbstractEventDispatcher::~QAbstractEventDispatcher()

Löscht den Ereignis-Dispatcher.

[signal] void QAbstractEventDispatcher::aboutToBlock()

Dieses Signal wird ausgesendet, bevor die Ereignisschleife eine Funktion aufruft, die blockieren könnte.

Siehe auch ` awake()`.

[signal] void QAbstractEventDispatcher::awake()

Dieses Signal wird ausgesendet, nachdem die Ereignisschleife von einer Funktion zurückgekehrt ist, die blockieren könnte.

Siehe auch „ wakeUp()“ und „ aboutToBlock()“.

bool QAbstractEventDispatcher::filterNativeEvent(const QByteArray &eventType, void *message, qintptr *result)

Leitet „ message “ durch die Ereignisfilter, die mit „ installNativeEventFilter()“ festgelegt wurden. Diese Funktion gibt „ true “ zurück, sobald ein Ereignisfilter „ true “ zurückgibt, andernfalls „false“, um anzuzeigen, dass die Verarbeitung des Ereignisses fortgesetzt werden soll.

Unterklassen von ` QAbstractEventDispatcher ` müssen diese Funktion für alle vom System empfangenen Nachrichten aufrufen, um die Kompatibilität mit etwaigen in der Anwendung verwendeten Erweiterungen zu gewährleisten. Der Typ des Ereignisses ` eventType ` ist spezifisch für das zur Laufzeit ausgewählte Plattform-Plugin und kann verwendet werden, um die Nachricht in den richtigen Typ umzuwandeln. Der Zeiger ` result ` wird nur unter Windows verwendet und entspricht dem LRESULT-Zeiger.

Beachten Sie, dass der Typ von ` message ` plattformabhängig ist. Weitere Informationen finden Sie unter ` QAbstractNativeEventFilter `.

Siehe auch installNativeEventFilter() und QAbstractNativeEventFilter::nativeEventFilter().

void QAbstractEventDispatcher::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

Installiert einen Ereignisfilter „ filterObj “ für alle nativen Ereignisse, die von der Anwendung empfangen werden.

Der Ereignisfilter „ filterObj “ empfängt Ereignisse über seine Funktion „ nativeEventFilter()“, die für alle von allen Threads empfangenen Ereignisse aufgerufen wird.

Die Funktion ` nativeEventFilter()` sollte `true` zurückgeben, wenn das Ereignis gefiltert (in diesem Fall gestoppt) werden soll. Sie sollte `false` zurückgeben, um die normale Qt-Verarbeitung fortzusetzen: Das native Ereignis kann dann in ein ` QEvent ` umgewandelt und durch die Standard-Qt-Filterung ` event ` verarbeitet werden, z. B. ` QObject::installEventFilter()`.

Sind mehrere Ereignisfilter installiert, wird der zuletzt installierte Filter zuerst aktiviert.

Um maximale Portabilität zu gewährleisten, sollten Sie nach Möglichkeit stets QEvent -Objekte und QObject::installEventFilter() verwenden.

Siehe auch ` QObject::installEventFilter()`.

[static] QAbstractEventDispatcher *QAbstractEventDispatcher::instance(QThread *thread = nullptr)

Gibt einen Zeiger auf das Event-Dispatcher-Objekt für den angegebenen Thread ` thread` zurück. Wenn ` thread ` gleich ` nullptr` ist, wird der aktuelle Thread verwendet. Wenn für den angegebenen Thread kein Event-Dispatcher vorhanden ist, gibt diese Funktion ` nullptr` zurück.

Hinweis: Wenn Qt ohne Thread-Unterstützung kompiliert wurde, wird das Argument ` thread ` ignoriert.

[pure virtual] void QAbstractEventDispatcher::interrupt()

Unterbricht die Ereignisausgabe. Der Ereignis-Dispatcher kehrt so schnell wie möglich aus der Funktion „ processEvents()“ zurück.

[pure virtual] bool QAbstractEventDispatcher::processEvents(QEventLoop::ProcessEventsFlags flags)

Verarbeitet ausstehende Ereignisse, die dem Flag „ flags “ entsprechen, bis keine Ereignisse mehr zu verarbeiten sind. Gibt „ true “ zurück, wenn ein Ereignis verarbeitet wurde; andernfalls wird „ false “ zurückgegeben.

Diese Funktion ist besonders nützlich, wenn Sie einen lang andauernden Vorgang ausführen und dessen Fortschritt anzeigen möchten, ohne Benutzereingaben zuzulassen, indem Sie das Flag „ QEventLoop::ExcludeUserInputEvents “ verwenden.

Ist das Flag „ QEventLoop::WaitForMoreEvents “ in ` flags` gesetzt, verhält sich diese Funktion wie folgt:

• Sind Ereignisse verfügbar, kehrt diese Funktion nach deren Verarbeitung zurück.
• Sind keine Ereignisse verfügbar, wartet diese Funktion, bis weitere verfügbar sind, und kehrt nach der Verarbeitung der neu verfügbaren Ereignisse zurück.

Ist das Flag „ QEventLoop::WaitForMoreEvents “ in ` flags` nicht gesetzt und sind keine Ereignisse verfügbar, kehrt diese Funktion sofort zurück.

Hinweis: Diese Funktion verarbeitet Ereignisse nicht kontinuierlich; sie kehrt zurück, nachdem alle verfügbaren Ereignisse verarbeitet wurden.

[pure virtual] void QAbstractEventDispatcher::registerSocketNotifier(QSocketNotifier *notifier)

Registriert „ notifier “ in der Ereignisschleife. Unterklassen müssen diese Methode implementieren, um einen Socket-Notifier in eine andere Ereignisschleife einzubinden.

[since 6.8] void QAbstractEventDispatcher::registerTimer(Qt::TimerId timerId, QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

Registriere einen Timer mit den angegebenen Werten für „ timerId “, „ interval “ und „ timerType “ für die angegebene „ object “.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch unregisterTimer() und timersForObject().

[pure virtual] void QAbstractEventDispatcher::registerTimer(int timerId, qint64 interval, Qt::TimerType timerType, QObject *object)

Registriere einen Timer mit den angegebenen Werten „ timerId “, „ interval “ und „ timerType “ für die angegebene „ object “.

[since 6.8] Qt::TimerId QAbstractEventDispatcher::registerTimer(QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)

Registriert einen Timer mit den angegebenen Werten „ interval “ und „ timerType “ für die angegebene „ object “ und gibt die Timer-ID zurück.

Diese Funktion wurde in Qt 6.8 eingeführt.

[pure virtual] QList<QAbstractEventDispatcher::TimerInfo> QAbstractEventDispatcher::registeredTimers(QObject *object) const

Gibt eine Liste der registrierten Timer für „ object “ zurück. Die Struktur „TimerInfo“ enthält die Elemente „ timerId “, „ interval “ und „ timerType “.

Siehe auch Qt::TimerType.

[pure virtual] int QAbstractEventDispatcher::remainingTime(int timerId)

Gibt die verbleibende Zeit in Millisekunden für den angegebenen „ timerId “ zurück. Ist der Timer inaktiv, beträgt der Rückgabewert -1. Ist der Timer abgelaufen, beträgt der Rückgabewert 0.

Siehe auch ` Qt::TimerType`.

QAbstractEventDispatcher::Duration QAbstractEventDispatcher::remainingTime(Qt::TimerId timerId) const

Gibt die verbleibende Zeit des Timers mit dem angegebenen „ timerId “ zurück. Ist der Timer inaktiv, ist der zurückgegebene Wert negativ. Ist der Timer abgelaufen, ist der zurückgegebene Wert 0.

Siehe auch „ Qt::TimerType“ , „ registerTimer()“ und „ unregisterTimer()“.

void QAbstractEventDispatcher::removeNativeEventFilter(QAbstractNativeEventFilter *filter)

Entfernt den Ereignisfilter „ filter “ aus diesem Objekt. Die Anforderung wird ignoriert, wenn kein solcher Ereignisfilter installiert wurde.

Alle Ereignisfilter für dieses Objekt werden automatisch entfernt, wenn dieses Objekt zerstört wird.

Das Entfernen eines Ereignisfilters ist stets unbedenklich, selbst während der Aktivierung des Ereignisfilters (d. h. sogar innerhalb der Funktion ` nativeEventFilter()`).

Siehe auch „ installNativeEventFilter()“ und „ QAbstractNativeEventFilter “.

[since 6.8] QList<QAbstractEventDispatcher::TimerInfoV2> QAbstractEventDispatcher::timersForObject(QObject *object) const

Gibt eine Liste der registrierten Timer für „ object “ zurück. Die Struktur „ TimerInfoV2 “ verfügt über die Elemente „ timerId “, „ interval “ und „ timerType “.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch „ Qt::TimerType“ , „ registerTimer()“ und „ unregisterTimer()“.

[pure virtual] void QAbstractEventDispatcher::unregisterSocketNotifier(QSocketNotifier *notifier)

Entfernt „ notifier “ aus dem Ereignis-Dispatcher. Unterklassen müssen diese Methode neu implementieren, um einen Socket-Notifier in eine andere Ereignisschleife einzubinden. Bei einer Neuimplementierung muss die Basisimplementierung aufgerufen werden.

[since 6.8] bool QAbstractEventDispatcher::unregisterTimer(Qt::TimerId timerId)

Hebt die Registrierung des Timers mit dem angegebenen „ timerId “ auf. Gibt bei Erfolg „ true “ zurück; andernfalls „ false “.

Diese Funktion wurde in Qt 6.8 eingeführt.

Siehe auch ` registerTimer()` und ` unregisterTimers()`.

[pure virtual] bool QAbstractEventDispatcher::unregisterTimer(int timerId)

Hebt die Registrierung des Timers mit dem angegebenen timerId auf. Gibt bei Erfolg true zurück; andernfalls wird false zurückgegeben.

Siehe auch ` registerTimer()` und ` unregisterTimers()`.

[pure virtual] bool QAbstractEventDispatcher::unregisterTimers(QObject *object)

Hebt die Registrierung aller Timer auf, die mit dem angegebenen ` object` verknüpft sind. Gibt ` true ` zurück, wenn alle Timer erfolgreich entfernt wurden; andernfalls wird ` false` zurückgegeben.

Siehe auch ` unregisterTimer()` und ` registeredTimers()`.

[pure virtual] void QAbstractEventDispatcher::wakeUp()

Weckt die Ereignisschleife auf.

Hinweis: Diese Funktion ist threadsicher.

Siehe auch ` awake()`.