En esta página

QtTaskTree::QSyncTask Class

class QtTaskTree::QSyncTask

Ejecuta de forma sincrónica un controlador personalizado entre otras tareas. 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
Heredado de: QtTaskTree::ExecutableItem
Estado: Vista previa tecnológica

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

QSyncTask(Handler &&handler)

Descripción detallada

QSyncTask resulta útil cuando se desea ejecutar un controlador adicional entre otras tareas. QSyncTask es considerado por su clase padre ( Group ) como cualquier otra tarea. Evita que el cuerpo del controlador de QSyncTask se ejecute durante mucho tiempo, ya que se ejecuta de forma sincrónica desde el hilo de llamada. Si esto es inevitable, considera utilizar en su lugar un « QThreadFunctionTask ».

Documentación de las funciones de miembro

[explicit] template <typename Handler, std::enable_if_t<!std::is_same_v<q20::remove_cvref_t<Handler>, QSyncTask>, bool> = true> QSyncTask::QSyncTask(Handler &&handler)

Crea un elemento que ejecuta de forma sincrónica el ` handler ` que se le pasa como parámetro. El ` Handler ` es de tipo ` std::function<DoneResult()> `. El valor ` DoneResult `, devuelto por ` handler`, se tiene en cuenta durante la resolución del grupo padre ` workflow policy `. Opcionalmente, también se acepta la forma abreviada ` std::function<void()> `. En este caso, se supone que el valor devuelto es ` DoneResult::Success`.

El ` handler ` pasado se ejecuta de forma sincrónica desde el hilo del llamante, por lo que se debe evitar una ejecución prolongada del cuerpo del controlador. De lo contrario, se recomienda utilizar ` QThreadFunctionTask`.

Nota: El elemento QSyncTask no se cuenta como una tarea a la hora de informar del progreso del árbol de tareas, y no se incluye en QTaskTree::taskCount() ni en QTaskTree::progressMaximum().

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