QEventLoop Class

Documentación de Funciones Miembro

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

Construye un objeto de bucle de eventos con la dirección parent.

[virtual noexcept] QEventLoop::~QEventLoop()

Destruye el objeto de 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 principal de eventos y espera hasta que se llame a exit(). Devuelve el valor que se pasó a exit().

Si se especifica flags, sólo se procesarán los eventos de los tipos permitidos por flags.

Es necesario llamar a esta función para iniciar el manejo de eventos. El bucle principal de eventos recibe eventos del sistema de ventanas y los envía a los widgets de la aplicación.

En general, ninguna interacción del usuario puede tener lugar antes de llamar a exec(). Como caso especial, los widgets modales como QMessageBox pueden usarse antes de llamar a exec(), porque los widgets modales usan su propio bucle de eventos local.

Para que tu aplicación realice un procesamiento en reposo (es decir, ejecute una función especial siempre que no haya eventos pendientes), utiliza QChronoTimer con un tiempo de espera de 0ns. Se pueden conseguir esquemas de procesamiento inactivo 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 salga con un código de retorno.

Después de llamar a 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í devuelve al invocador: es el procesamiento de eventos el que se detiene.

Véase también QCoreApplication::quit(), quit(), y exec().

bool QEventLoop::isRunning() const

Devuelve true si el bucle de eventos se está ejecutando; en caso contrario devuelve false. El bucle de eventos se considera 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 es especialmente útil si tiene una operación de larga duración y desea mostrar su progreso sin permitir la entrada del usuario; es decir, utilizando la bandera ExcludeUserInputEvents.

Esta función es simplemente una envoltura para QAbstractEventDispatcher::processEvents(). Consulte la documentación de esa función para más detalles.

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

Procesa los eventos pendientes que coincidan con flags hasta que deadline haya expirado, o hasta que no haya más eventos que procesar, lo que ocurra primero. Esta función es especialmente útil si tiene una operación de larga duración y desea mostrar su progreso sin permitir la entrada del usuario, es decir, utilizando la bandera ExcludeUserInputEvents.

Notas:

• Esta función no procesa los eventos de forma continua; vuelve después de que se hayan procesado todos los eventos disponibles.
• Especificar la bandera WaitForMoreEvents no tiene sentido y será ignorada.

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 haya más eventos que procesar, lo que sea más corto.

Equivale a llamar:

processEvents(flags, QDeadlineTimer(maxTime));

[slot] void QEventLoop::quit()

Indica al bucle de eventos que salga normalmente.

Igual que exit(0).

Véase también QCoreApplication::quit() y exit().

void QEventLoop::wakeUp()

Activa el bucle de eventos.

Véase también QAbstractEventDispatcher::wakeUp().