En esta página

QtTaskTree::QBarrier Class

class QtTaskTree::QBarrier

Una tarea asíncrona que finaliza cuando se le solicita. Más información...

Encabezado: #include <qbarriertask.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS TaskTree)
target_link_libraries(mytarget PRIVATE Qt6::TaskTree)
qmake: QT += tasktree
Desde: Qt 6.11
Heredado de: QObject
Heredado por:

QtTaskTree::QStartedBarrier

Estado: Vista previa tecnológica

Esta clase se encuentra en fase de avance tecnológico y está sujeta a cambios.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

QBarrier(QObject *parent)
void advance()
qsizetype current() const
bool isRunning() const
qsizetype limit() const
std::optional<QtTaskTree::DoneResult> result() const
void setLimit(qsizetype value)
void start()
void stopWithResult(QtTaskTree::DoneResult result)

Señales

void done(QtTaskTree::DoneResult result)

Funciones protegidas reimplementadas

virtual bool event(QEvent *event) override

Descripción detallada

QBarrier espera a que las llamadas posteriores a advance() alcancen el límite de la barrera (1 por defecto). Finaliza con DoneResult::Success.

Se utiliza a menudo en recetas de QTaskTree para retener la ejecución de tareas secuenciales posteriores hasta que alguna otra tarea en ejecución entregue los datos necesarios para configurar las tareas siguientes.

Documentación de funciones miembro

[explicit] QBarrier::QBarrier(QObject *parent)

Crea un objeto `QBarrier` con un ` parent` dado.

void QBarrier::advance()

Avanza la barrera. Si el número de llamadas a advance() alcanza el límite de la barrera, esta finaliza con un « DoneResult::Success ».

qsizetype QBarrier::current() const

Devuelve el recuento actual de avances de la barrera.

[private signal] void QBarrier::done(QtTaskTree::DoneResult result)

Esta señal se emite cuando finaliza la barrera, al superar el « result » final de la ejecución.

Nota: Se trata de una señal privada. Se puede utilizar en conexiones de señales, pero el usuario no puede emitirla.

[override virtual protected] bool QBarrier::event(QEvent *event)

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

bool QBarrier::isRunning() const

Devuelve « true » si la barrera está actualmente en ejecución; en caso contrario, devuelve « false ».

qsizetype QBarrier::limit() const

Devuelve el límite actual de la barrera.

Véase también setLimit().

std::optional<QtTaskTree::DoneResult> QBarrier::result() const

Devuelve el resultado de la ejecución de la barrera. Si la barrera no se ha iniciado o aún se está ejecutando, el objeto opcional devuelto está vacío. En caso contrario, devuelve el resultado de la última ejecución.

void QBarrier::setLimit(qsizetype value)

Establece el límite en value. Una vez iniciada, la barrera finaliza cuando el número de llamadas a advance() alcanza el límite.

Véase también limit().

void QBarrier::start()

Activa la barrera.

void QBarrier::stopWithResult(QtTaskTree::DoneResult result)

Detiene la barrera en marcha de forma incondicional con un valor de « result » dado. Se ignora el límite de la barrera.

© 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.