QEventLoop Class
La clase QEventLoop permite entrar y salir de un bucle de eventos. Más información...
| Encabezado: | #include <QEventLoop> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Core) target_link_libraries(mytarget PRIVATE Qt6::Core) |
| qmake: | QT += core |
| Heredan: | QObject |
Tipos públicos
| enum | ProcessEventsFlag { AllEvents, ExcludeUserInputEvents, ExcludeSocketNotifiers, WaitForMoreEvents } |
| flags | ProcessEventsFlags |
Funciones públicas
| QEventLoop(QObject *parent = nullptr) | |
| virtual | ~QEventLoop() |
| int | exec(QEventLoop::ProcessEventsFlags flags = AllEvents) |
| bool | isRunning() const |
| bool | processEvents(QEventLoop::ProcessEventsFlags flags = AllEvents) |
(since 6.7) void | processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline) |
| void | processEvents(QEventLoop::ProcessEventsFlags flags, int maxTime) |
| void | wakeUp() |
Funciones públicas reimplementadas
| virtual bool | event(QEvent *event) override |
Ranuras públicas
Descripción detallada
En cualquier momento, puedes crear un objeto `QEventLoop` y llamar a ` exec()` en él para iniciar un bucle de eventos local. Desde dentro del bucle de eventos, llamar a ` exit()` forzará a ` exec()` a regresar.
Véase también QAbstractEventDispatcher.
Documentación sobre tipos de miembros
enum QEventLoop::ProcessEventsFlag
flags QEventLoop::ProcessEventsFlags
Esta enumeración controla los tipos de eventos que procesan las funciones processEvents().
| Constante | Valor | Descripción |
|---|---|---|
QEventLoop::AllEvents | 0x00 | Todos los eventos. Ten en cuenta que los eventos de ` DeferredDelete ` se procesan de forma especial. Consulta ` QObject::deleteLater()` para obtener más detalles. |
QEventLoop::ExcludeUserInputEvents | 0x01 | No procesar eventos de entrada del usuario, como ButtonPress y KeyPress. Ten en cuenta que los eventos no se descartan; se entregarán la próxima vez que se llame a processEvents() sin el indicador ExcludeUserInputEvents. |
QEventLoop::ExcludeSocketNotifiers | 0x02 | No procese los eventos de notificadores de socket. Tenga en cuenta que los eventos no se descartan; se entregarán la próxima vez que se llame a processEvents() sin el indicador ExcludeSocketNotifiers. |
QEventLoop::WaitForMoreEvents | 0x04 | Espera a que haya eventos disponibles si no hay ninguno pendiente. |
El tipo `ProcessEventsFlags` es una definición de tipo (`typedef`) para ` QFlags<ProcessEventsFlag>`. Almacena una combinación OR de valores de `ProcessEventsFlag`.
Véase también ` processEvents()`.
Documentación de las funciones de miembro
[explicit] QEventLoop::QEventLoop(QObject *parent = nullptr)
Crea un objeto de bucle de eventos con el ` parent` indicado.
[virtual noexcept] QEventLoop::~QEventLoop()
Destruye el objeto del bucle de eventos.
[override virtual] bool QEventLoop::event(QEvent *event)
Reimplementa: QObject::event(QEvent *e).
int QEventLoop::exec(QEventLoop::ProcessEventsFlags flags = AllEvents)
Entra en el bucle de eventos principal y espera hasta que se llame a ` exit()`. Devuelve el valor que se pasó a ` exit()`.
Si se especifican flags, solo se procesarán los eventos de los tipos permitidos por flags.
Es necesario llamar a esta función para iniciar la gestión de eventos. El bucle de eventos principal recibe eventos del sistema de ventanas y los distribuye a los widgets de la aplicación.
En términos generales, no puede producirse ninguna interacción del usuario antes de llamar a `exec()`. Como caso especial, los widgets modales, como ` QMessageBox `, pueden utilizarse antes de llamar a `exec()`, ya que los widgets modales utilizan su propio bucle de eventos local.
Para que su aplicación realice un procesamiento en espera (es decir, que ejecute una función especial siempre que no haya eventos pendientes), utilice un ` QChronoTimer ` con un tiempo de espera de 0 ns. Se pueden conseguir esquemas de procesamiento en espera más sofisticados utilizando ` processEvents()`.
Véase también QCoreApplication::quit(), exit() y processEvents().
[slot] void QEventLoop::exit(int returnCode = 0)
Indica al bucle de eventos que finalice con un código de retorno.
Una vez llamada esta función, el bucle de eventos vuelve de la llamada a exec(). La función exec() devuelve returnCode.
Por convención, un ` returnCode ` de 0 significa éxito, y cualquier valor distinto de cero indica un error.
Tenga en cuenta que, a diferencia de la función de la biblioteca C del mismo nombre, esta función sí vuelve al llamante: lo que se detiene es el procesamiento de eventos.
Véanse también QCoreApplication::quit(), quit() y exec().
bool QEventLoop::isRunning() const
Devuelve ` true ` si el bucle de eventos está en ejecución; en caso contrario, devuelve `false`. Se considera que el bucle de eventos está en ejecución desde el momento en que se llama a ` exec()` hasta que se llama a ` exit()`.
Véase también exec() y exit().
bool QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags = AllEvents)
Procesa algunos eventos pendientes que coinciden con ` flags`. Devuelve ` true ` si se han gestionado los eventos pendientes; en caso contrario, devuelve ` false`.
Esta función resulta especialmente útil si tienes una operación de larga duración y deseas mostrar su progreso sin permitir la entrada del usuario; es decir, utilizando el indicador ExcludeUserInputEvents.
Esta función es simplemente una envoltura de QAbstractEventDispatcher::processEvents(). Consulte la documentación de dicha función para obtener más detalles.
[since 6.7] void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, QDeadlineTimer deadline)
Procesa los eventos pendientes que coincidan con flags hasta que caduque deadline, o hasta que no queden más eventos por procesar, lo que ocurra primero. Esta función resulta especialmente útil si tienes una operación de larga duración y deseas mostrar su progreso sin permitir la intervención del usuario, es decir, utilizando el indicador ExcludeUserInputEvents.
Notas:
- Esta función no procesa eventos de forma continua; devuelve un resultado una vez que se han procesado todos los eventos disponibles.
- Especificar el indicador « WaitForMoreEvents » no tiene sentido y se ignorará.
Esta función se introdujo en Qt 6.7.
void QEventLoop::processEvents(QEventLoop::ProcessEventsFlags flags, int maxTime)
Procesa los eventos pendientes que coincidan con flags durante un máximo de maxTime milisegundos, o hasta que no queden más eventos que procesar, lo que sea más corto.
Equivalente a llamar a:
processEvents(flags, QDeadlineTimer(maxTime));Esta es una función sobrecargada.
[slot] void QEventLoop::quit()
Indica al bucle de eventos que finalice de forma normal.
Equivale a exit(0).
Véase también QCoreApplication::quit() y exit().
void QEventLoop::wakeUp()
Activa el bucle de eventos.
Véase también QAbstractEventDispatcher::wakeUp().
© 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.