En esta página

QAbstractEventDispatcher Class

La clase `QAbstractEventDispatcher` proporciona una interfaz para gestionar la cola de eventos de Qt. Más información...

Encabezado: #include <QAbstractEventDispatcher>
CMake: find_package(Qt6 REQUIRED COMPONENTS Core)
target_link_libraries(mytarget PRIVATE Qt6::Core)
qmake: QT += core
Heredado de: QObject
Heredado por:

QAbstractEventDispatcherV2

Tipos públicos

Funciones públicas

QAbstractEventDispatcher(QObject *parent = nullptr)
virtual ~QAbstractEventDispatcher()
bool filterNativeEvent(const QByteArray &eventType, void *message, qintptr *result)
void installNativeEventFilter(QAbstractNativeEventFilter *filterObj)
virtual void interrupt() = 0
virtual bool processEvents(QEventLoop::ProcessEventsFlags flags) = 0
virtual void registerSocketNotifier(QSocketNotifier *notifier) = 0
(since 6.8) void registerTimer(Qt::TimerId timerId, QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)
virtual void registerTimer(int timerId, qint64 interval, Qt::TimerType timerType, QObject *object) = 0
(since 6.8) Qt::TimerId registerTimer(QAbstractEventDispatcher::Duration interval, Qt::TimerType timerType, QObject *object)
virtual QList<QAbstractEventDispatcher::TimerInfo> registeredTimers(QObject *object) const = 0
virtual int remainingTime(int timerId) = 0
QAbstractEventDispatcher::Duration remainingTime(Qt::TimerId timerId) const
void removeNativeEventFilter(QAbstractNativeEventFilter *filter)
(since 6.8) QList<QAbstractEventDispatcher::TimerInfoV2> timersForObject(QObject *object) const
virtual void unregisterSocketNotifier(QSocketNotifier *notifier) = 0
(since 6.8) bool unregisterTimer(Qt::TimerId timerId)
virtual bool unregisterTimer(int timerId) = 0
virtual bool unregisterTimers(QObject *object) = 0
virtual void wakeUp() = 0

Señales

void aboutToBlock()
void awake()

Miembros públicos estáticos

QAbstractEventDispatcher *instance(QThread *thread = nullptr)

Descripción detallada

Un distribuidor de eventos recibe eventos del sistema de ventanas y de otras fuentes. A continuación, los envía a la instancia de ` QCoreApplication ` o ` QApplication ` para su procesamiento y entrega. `QAbstractEventDispatcher` proporciona un control preciso sobre la entrega de eventos.

Para un control sencillo del procesamiento de eventos, utiliza QCoreApplication::processEvents().

Para un control más preciso del bucle de eventos de la aplicación, llama a instance() y utiliza las funciones del objeto QAbstractEventDispatcher que se devuelve. Si desea utilizar su propia instancia de `QAbstractEventDispatcher` o de una subclase de `QAbstractEventDispatcher`, debe instalarla con ` QCoreApplication::setEventDispatcher()` o ` QThread::setEventDispatcher()` antes de que se haya instalado el distribuidor de eventos predeterminado.

El bucle de eventos principal se inicia llamando a ` QCoreApplication::exec()` y se detiene llamando a ` QCoreApplication::exit()`. Se pueden crear bucles de eventos locales utilizando ` QEventLoop`.

Los programas que realizan operaciones prolongadas pueden llamar a processEvents() con una combinación OR bit a bit de varios valores de QEventLoop::ProcessEventsFlag para controlar qué eventos deben entregarse.

QAbstractEventDispatcher también permite la integración de un bucle de eventos externo con el bucle de eventos de Qt.

Véase también QEventLoop, QCoreApplication y QThread.

Documentación sobre los tipos de miembros

[alias] QAbstractEventDispatcher::Duration

Un tipo de « std::chrono::duration » que se utiliza en varias API de esta clase. Este tipo existe para facilitar una posible transición a una granularidad mayor o menor.

En todas las plataformas actuales, es de tipo « nanoseconds ».

Documentación de las funciones miembro

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

Crea un nuevo distribuidor de eventos con el ` parent` indicado.

[virtual noexcept] QAbstractEventDispatcher::~QAbstractEventDispatcher()

Elimina el distribuidor de eventos.

[signal] void QAbstractEventDispatcher::aboutToBlock()

Esta señal se emite antes de que el bucle de eventos llame a una función que pudiera bloquearse.

Véase también awake().

[signal] void QAbstractEventDispatcher::awake()

Esta señal se emite después de que el bucle de eventos regrese de una función que podría bloquearse.

Véase también wakeUp() y aboutToBlock().

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

Envía message a través de los filtros de eventos configurados mediante installNativeEventFilter(). Esta función devuelve true en cuanto un filtro de eventos devuelva true, y false en caso contrario para indicar que el procesamiento del evento debe continuar.

Las subclases de ` QAbstractEventDispatcher ` deben llamar a esta función para todos los mensajes recibidos del sistema, a fin de garantizar la compatibilidad con cualquier extensión que pueda utilizarse en la aplicación. El tipo de evento ` eventType ` es específico del complemento de plataforma elegido en tiempo de ejecución, y puede utilizarse para convertir el mensaje al tipo adecuado. El puntero ` result ` solo se utiliza en Windows, y se corresponde con el puntero `LRESULT`.

Tenga en cuenta que el tipo de message depende de la plataforma. Consulte QAbstractNativeEventFilter para obtener más detalles.

Véanse también installNativeEventFilter() y QAbstractNativeEventFilter::nativeEventFilter().

void QAbstractEventDispatcher::installNativeEventFilter(QAbstractNativeEventFilter *filterObj)

Instala un filtro de eventos filterObj para todos los eventos nativos que reciba la aplicación.

El filtro de eventos filterObj recibe eventos a través de su función nativeEventFilter(), que se invoca para todos los eventos recibidos por todos los hilos.

La función nativeEventFilter() debe devolver «true» si el evento debe filtrarse (en este caso, detenerse). Debe devolver «false» para permitir que continúe el procesamiento normal de Qt: el evento nativo puede entonces traducirse a un QEvent y gestionarse mediante el filtrado estándar de Qt event, por ejemplo, QObject::installEventFilter().

Si hay varios filtros de eventos instalados, se activa primero el último que se haya instalado.

Nota: La función de filtro definida aquí recibe mensajes nativos, es decir, estructuras MSG o XEvent.

Para garantizar la máxima portabilidad, debes intentar utilizar siempre objetos ` QEvent ` y ` QObject::installEventFilter()` siempre que sea posible.

Véase también QObject::installEventFilter().

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

Devuelve un puntero al objeto distribuidor de eventos del hilo especificado ` thread`. Si ` thread ` es ` nullptr`, se utiliza el hilo actual. Si no existe ningún distribuidor de eventos para el hilo especificado, esta función devuelve ` nullptr`.

Nota: Si Qt se compila sin soporte para subprocesos, se ignora el argumento ` thread `.

[pure virtual] void QAbstractEventDispatcher::interrupt()

Interrumpe el envío de eventos. El distribuidor de eventos saldrá de la función ` processEvents()` lo antes posible.

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

Procesa los eventos pendientes que coincidan con « flags » hasta que no queden más eventos por procesar. Devuelve « true » si se ha procesado un evento; en caso contrario, devuelve « false ».

Esta función resulta especialmente útil si se está llevando a cabo una operación de larga duración y se desea mostrar su progreso sin permitir la intervención del usuario mediante el uso del indicador « QEventLoop::ExcludeUserInputEvents ».

Si se establece el indicador « QEventLoop::WaitForMoreEvents » en ` flags`, el comportamiento de esta función es el siguiente:

  • Si hay eventos disponibles, esta función devuelve el resultado tras procesarlos.
  • Si no hay eventos disponibles, esta función esperará hasta que haya más y volverá tras procesar los eventos recién disponibles.

Si el indicador « QEventLoop::WaitForMoreEvents » no está activado en ` flags` y no hay eventos disponibles, esta función devolverá un valor inmediatamente.

Nota: Esta función no procesa eventos de forma continua; devuelve un resultado una vez procesados todos los eventos disponibles.

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

Registra notifier en el bucle de eventos. Las subclases deben implementar este método para vincular un notificador de socket a otro bucle de eventos.

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

Registra un temporizador con los valores especificados para timerId, interval y timerType para el object dado.

Esta función se introdujo en Qt 6.8.

Véase también unregisterTimer() y timersForObject().

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

Registrar un temporizador con los valores especificados timerId, interval y timerType para el object dado.

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

Registra un temporizador con los valores especificados en « interval » y « timerType » para el « object » indicado y devuelve el identificador del temporizador.

Esta es una función sobrecargada.

Esta función se introdujo en Qt 6.8.

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

Devuelve una lista de temporizadores registrados para object. La estructura TimerInfo tiene los miembros timerId, interval y timerType.

Véase también Qt::TimerType.

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

Devuelve el tiempo restante en milisegundos con el ` timerId` indicado. Si el temporizador está inactivo, el valor devuelto será -1. Si el temporizador ha caducado, el valor devuelto será 0.

Véase también Qt::TimerType.

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

Devuelve el tiempo restante del temporizador con el timerId especificado. Si el temporizador está inactivo, el valor devuelto será negativo. Si el temporizador ha vencido, el valor devuelto será 0.

Véase también Qt::TimerType, registerTimer() y unregisterTimer().

void QAbstractEventDispatcher::removeNativeEventFilter(QAbstractNativeEventFilter *filter)

Elimina el filtro de eventos « filter » de este objeto. La solicitud se ignora si dicho filtro de eventos no se ha instalado.

Todos los filtros de eventos de este objeto se eliminan automáticamente cuando se destruye dicho objeto.

Siempre es seguro eliminar un filtro de eventos, incluso durante la activación del filtro (es decir, incluso desde dentro de la función nativeEventFilter()).

Véase también installNativeEventFilter() y QAbstractNativeEventFilter.

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

Devuelve una lista de temporizadores registrados para object. La estructura TimerInfoV2 tiene los miembros timerId, interval y timerType.

Esta función se introdujo en Qt 6.8.

Véase también Qt::TimerType, registerTimer() y unregisterTimer().

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

Da de baja a ` notifier ` del distribuidor de eventos. Las subclases deben reimplementar este método para vincular un notificador de socket a otro bucle de eventos. Las reimplementaciones deben llamar a la implementación base.

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

Desregistra el temporizador con el timerId especificado. Devuelve true si se realiza correctamente; en caso contrario, devuelve false.

Esta función se introdujo en Qt 6.8.

Véase también registerTimer() y unregisterTimers().

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

Desregistra el temporizador con el timerId indicado. Devuelve true si se realiza correctamente; en caso contrario, devuelve false.

Véanse también registerTimer() y unregisterTimers().

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

Da de baja todos los temporizadores asociados al objeto ` object` indicado. Devuelve ` true ` si se han eliminado correctamente todos los temporizadores; en caso contrario, devuelve ` false`.

Véase también unregisterTimer() y registeredTimers().

[pure virtual] void QAbstractEventDispatcher::wakeUp()

Activa el bucle de eventos.

Nota: Esta función es segura para subprocesos.

Véase también ` awake()`.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.