En esta página

QtTaskTree::Do Class

class QtTaskTree::Do

Un elemento del cuerpo que se utiliza con las construcciones «For» y «When». Más información...

Encabezado: #include <qtasktree.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

Do(const QtTaskTree::GroupItems &children)
Do(std::initializer_list<QtTaskTree::GroupItem> children)
Do(QtTaskTree::Do &&other)
QtTaskTree::Group operator>>(const QtTaskTree::When &whenItem, const QtTaskTree::Do &doItem)

Descripción detallada

Un elemento de cuerpo que contiene una lista de tareas que se ejecutarán en cada iteración de « For » o después de que se haya avanzado la barrera de « When ».

For (RepeatIterator(5)) >> Do {
    task1,
    task2
};

En el caso de un bucle «For», el cuerpo de «Do» se ejecutará varias veces. Si los manejadores de « onGroupSetup()» o « onGroupDone()» forman parte de los elementos hijos pasados al constructor de «Do», se ejecutarán solo una vez: antes de que comience todo el bucle y después de que este haya finalizado:

const RepeatIterator iterator(3);

const auto onSetup = [] { qDebug() << "Setup"; };

const auto onSync = [iterator] { qDebug() << "Current iteration:" << iterator->iteration(); };

const auto onDone = [] { qDebug() << "Done"; };

const Group recipe = For (iterator) >> Do {
    onGroupSetup(onSetup),
    QSyncTask(onSync),
    onDone(onDone)
};

La receta anterior, al ejecutarse, mostrará el siguiente resultado:

Setup
Current iteration: 0
Current iteration: 1
Current iteration: 2
Done

Si la intención es invocar los controladores del grupo en cada iteración, hay que encerrar el cuerpo de «Do» con un « Group » adicional, de la siguiente manera:

const Group recipe = For (iterator) >> Do {
    Group {
        onGroupSetup(onSetup),
        QSyncTask(onSync),
        onDone(onDone)
    }
};

Al ejecutarse, la última receta mostrará:

Setup
Current iteration: 0
Done
Setup
Current iteration: 1
Done
Setup
Current iteration: 2
Done

Algo similar ocurre cuando el ` Storage ` se pasa como elemento secundario directo del cuerpo. La estructura de almacenamiento se instancia una sola vez, antes de que comience el bucle completo, y se destruye justo después de que este haya finalizado. Si la intención es tener una instancia independiente de ` Storage ` para cada iteración, envuelve el cuerpo de `Do` con un ` Group` adicional.

Ten cuidado al colocar un elemento ` parallel ` en el cuerpo del `Do` del bucle ` For `, ya que todas las iteraciones se iniciarán en paralelo. Esto podría no ser deseable, especialmente en el caso de ` ForeverIterator`.

Véase también For y When.

Documentación de las funciones miembro

[explicit] Do::Do(const QtTaskTree::GroupItems &children)

Crea un cuerpo «Do» con « children » que se ejecutará en cada iteración de « For » o después de que se haya avanzado la barrera de « When ».

[explicit] Do::Do(std::initializer_list<QtTaskTree::GroupItem> children)

Crea un cuerpo «Do» con « children » como lista de inicializadores.

Esta es una función sobrecargada.

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

Crea una instancia de ` Do`.

Elementos no miembros relacionados

QtTaskTree::Group operator>>(const QtTaskTree::When &whenItem, const QtTaskTree::Do &doItem)

Combina ` whenItem ` con el cuerpo de ` doItem ` y devuelve un ` Group ` listo para utilizarse en recetas del árbol de tareas.

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