En esta página

QtTaskTree::If Class

class QtTaskTree::If

Un elemento «if» utilizado en expresiones condicionales. Más...

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

If(const QtTaskTree::ExecutableItem &condition)
If(Handler &&handler)
If(QtTaskTree::If &&other)

Descripción detallada

Un elemento de condición inicial de las expresiones condicionales. Debe ir siempre seguido de un element Then.

Las expresiones condicionales del módulo TaskTree permiten procesar las condiciones de ramificación y sus cuerpos de forma asíncrona. Por ejemplo:

const Group recipe {
    If (conditionTask1) >> Then {
        bodyTask1
    } >> ElseIf (conditionTask2) >> Then {
        bodyTask2
    } >> Else {
        bodyTask3
    }
};

Cuando se ejecuta la receta anterior con ` QTaskTree`, el árbol de tareas inicia primero la instrucción asíncrona ` conditionTask1 `. Una vez finalizada, dependiendo del resultado, el árbol de tareas puede ejecutar ` bodyTask1 ` si ` conditionTask1 ` ha finalizado con éxito, o bien enviar otra condición ejecutando ` conditionTask2 ` en caso contrario. En caso de que se ejecute bodyTask1, no se ejecutan otras tareas, y el resultado de bodyTask1 es el resultado final de toda la expresión condicional.

Véase también Then, Else y ElseIf.

Documentación de funciones de miembro

[explicit] If::If(const QtTaskTree::ExecutableItem &condition)

Crea un elemento de condición inicial con una tarea « condition » para su uso en una expresión condicional. El « QTaskTree » en ejecución ejecuta primero la tarea « condition » pasada y, una vez finalizada, se ejecuta la rama « Then » (en caso de éxito) o, en caso contrario, la rama « Else » proporcionada opcionalmente o la condición « ElseIf ».

El condition pasado puede consistir en varias tareas incluidas en un elemento Group, o bien ser una conjunción o disyunción de las mismas, como por ejemplo:

const Group subRecipe {
    parallel,
    parallelConditionTask1,
    parallelConditionTask2
};

const Group recipe {
    If (conditionTask1 && !conditionTask2) >> Then {
        bodyTask1
    } >> ElseIf (subRecipe) >> Then {
        bodyTask2
    } >> Else {
        bodyTask3
    }
};

[explicit] template <typename Handler, std::enable_if_t<!std::is_base_of_v<ExecutableItem, std::decay_t<Handler>>, bool> = true> If::If(Handler &&handler)

Un constructor auxiliar que admite el ` handler ` síncrono que se ejecutará al evaluar la condición inicial mediante el ` QTaskTree` en ejecución.

Es un atajo para:

If (QSyncTask(handler))

Consulta QSyncTask para obtener más información sobre qué tipos de controladores son aceptables.

Esta es una función sobrecargada.

Véase también QSyncTask y ElseIf.

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

Crea una instancia de ` If` mediante la construcción «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.