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 la tarea. Más...

Cabecera: #include <QTaskBuilder>
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

No es posible crear un objeto de esta clase manualmente. Ver Tarea Concurrente para más detalles y ejemplos de uso.

Documentación de Funciones Miembro

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

Establece el grupo de hilos newThreadPool en el que se invocará la tarea.

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

Ejecuta la tarea en un hilo separado y devuelve un objeto future inmediatamente. Se trata de una llamada no bloqueante. Es posible que la tarea no se inicie inmediatamente.

void QTaskBuilder::spawn(QtConcurrent::FutureResult)

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

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

Establece los argumentos args con los que se invocará la tarea. El código está mal formado (causa 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 invocará la tarea.

Relacionados No miembros

[alias] InvokeResultType

La definición simplificada de este tipo tiene este aspecto:

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 contiene una comprobación en tiempo de compilación para saber 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.