En esta página

QtConcurrent::QTaskBuilder Class

template <typename Task, typename... Args> class QtConcurrent::QTaskBuilder

La clase QTaskBuilder se utiliza para ajustar los parámetros de las tareas. Más información...

Encabezado: #include <qtaskbuilder.h>
CMake: find_package(Qt6 REQUIRED COMPONENTS Concurrent)
target_link_libraries(mytarget PRIVATE Qt6::Concurrent)
qmake: QT += concurrent
Desde: Qt 6.0

Funciones públicas

QtConcurrent::QTaskBuilder<Task, Args...> &onThreadPool(QThreadPool &newThreadPool)
QFuture<QtConcurrent::InvokeResultType> spawn()
void spawn(QtConcurrent::FutureResult)
QtConcurrent::QTaskBuilder<Task, ExtraArgs...> withArguments(ExtraArgs &&... args)
QtConcurrent::QTaskBuilder<Task, Args...> &withPriority(int newPriority)

Descripción detallada

El parámetro de plantilla ` Task ` especifica el tipo invocable, y ` Args ` especifica los tipos de argumentos con los que se invocará la tarea.

No es posible crear un objeto de esta clase manualmente. Consulta «Tarea concurrente » para obtener más detalles y ejemplos de uso.

Documentación de las funciones de miembro

QtConcurrent::QTaskBuilder<Task, Args...> &QTaskBuilder::onThreadPool(QThreadPool &newThreadPool)

Establece el grupo de subprocesos newThreadPool en el que se ejecutará la tarea.

QFuture<QtConcurrent::InvokeResultType> QTaskBuilder::spawn()

Ejecuta la tarea en un hilo independiente y devuelve un objeto «future» de forma inmediata. Se trata de una llamada no bloqueante. Es posible que la tarea no se inicie de inmediato.

void QTaskBuilder::spawn(QtConcurrent::FutureResult)

Ejecuta la tarea en un hilo independiente. Se trata de una llamada no bloqueante. Es posible que la tarea no se inicie de inmediato.

template <typename... ExtraArgs> QtConcurrent::QTaskBuilder<Task, ExtraArgs...> QTaskBuilder::withArguments(ExtraArgs &&... args)

Establece los argumentos c args os con los que se invocará la tarea. El código presenta errores de sintaxis (provoca errores de compilación) si:

  • Esta función se invoca más de una vez.
  • El número de argumentos es cero.

QtConcurrent::QTaskBuilder<Task, Args...> &QTaskBuilder::withPriority(int newPriority)

Establece la prioridad newPriority con la que se ejecutará la tarea.

Elementos no miembros relacionados

[alias] InvokeResultType

La definición simplificada de este tipo es la siguiente:

template <class Task, class ...Args>
using InvokeResultType = std::invoke_result_t<std::decay_t<Task>, std::decay_t<Args>...>;

La implementación real también incluye una comprobación en tiempo de compilación para determinar si la tarea puede invocarse con los argumentos especificados o no.

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