En esta página

QtTaskTree::When Class

class QtTaskTree::When

Elemento que retrasa la ejecución de un cuerpo hasta que se supere una barrera. Más...

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
Estado: Versión preliminar

Esta clase se encuentra en fase de vista previa tecnológica y está sujeta a cambios.

Nota: Todas las funciones de esta clase son reentrantes.

Funciones públicas

When(const QtTaskTree::BarrierKickerGetter &kicker, QtTaskTree::WorkflowPolicy policy = WorkflowPolicy::StopOnError)
When(const QtTaskTree::QCustomTask<Task, Adapter, Deleter> &customTask, Signal signal, QtTaskTree::WorkflowPolicy policy = QtTaskTree::WorkflowPolicy::StopOnError)
When(QtTaskTree::When &&other)

Descripción detallada

Se utiliza para retrasar la ejecución del cuerpo de una función « Do » hasta que se avance el « QStoredBarrier » relacionado o hasta que se emita la señal de « QCustomTask ». Se utiliza junto con un elemento « Do », como en: « When () >> Do {} ».

Véase también Do.

Documentación de funciones de miembro

[explicit] When::When(const QtTaskTree::BarrierKickerGetter &kicker, QtTaskTree::WorkflowPolicy policy = WorkflowPolicy::StopOnError)

Crea un elemento de retardo que toma un ` kicker ` que devuelve un ` ExecutableItem ` para que se ejecute en paralelo con un cuerpo ` Do `. El cuerpo ` Do ` se retrasa hasta que avance el ` QStoredBarrier ` pasado al ` kicker `. El ` ExecutableItem ` devuelto por el ` kicker ` y el cuerpo ` Do ` se ejecutarán en paralelo utilizando el ` policy`.

Por ejemplo, si quieres retrasar la ejecución de las tareas posteriores hasta que se inicie el QProcess, la receta podría tener el siguiente aspecto:

const auto kicker = [](const QStoredBarrier &barrier) {
    const auto onSetup = [barrier](QProcess &process) {
        QObject::connect(&process, &QProcess::started, barrier.activeStorage(), &QBarrier::advance);
        ... // Setup process program, arguments, environment, etc...
    };
    return QProcessTask(onSetup);
};

const Group recipe {
    When (kicker) >> Do {
        delayedTask1,
        ...
    }
};

Cuando se ejecuta la receta anterior, el QTaskTree ejecuta un QProcessTask en paralelo con un cuerpo Do. Un cuerpo Do queda inicialmente en espera; continuará una vez que avance la barrera pasada al «kicker». Esto ocurrirá tan pronto como se inicie el QProcess. A partir de ese momento, QProcess se ejecuta en paralelo con el cuerpo Do.

Véase también Do.

[explicit] template < typename Task, typename Adapter, typename Deleter, typename Signal > When::When(const QtTaskTree::QCustomTask<Task, Adapter, Deleter> &customTask, Signal signal, QtTaskTree::WorkflowPolicy policy = QtTaskTree::WorkflowPolicy::StopOnError)

Crea un elemento de retardo, tomando customTask y su Task's signal para que se ejecuten en paralelo con un cuerpo Do. El cuerpo Do se retrasa hasta que se emite el Task's signal. El customTask y el cuerpo Do se ejecutarán en paralelo utilizando el policy.

El código del constructor del otro «When» podría simplificarse de la siguiente manera:

const auto onSetup = [barrier](QProcess &process) {
    ... // Setup process program, arguments, environment, etc...
};

const Group recipe {
    When (QProcessTask(onSetup), &QProcess::started) >> Do {
        delayedTask1,
        ...
    }
};

Nota: El tipo « Task » del « customTask » pasado debe derivarse de « QObject ».

Véase también ` Do`.

[constexpr noexcept default] When::When(QtTaskTree::When &&other)

Crea una instancia de ` When` mediante el operador `move`.

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