QtTaskTree::GroupItem Class
class QtTaskTree::GroupItemGroupItem representa el elemento básico que puede formar parte de cualquier Group. 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 por: | |
| 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.
Tipos públicos
Funciones públicas
| GroupItem(const QtTaskTree::GroupItems &children) | |
| GroupItem(const QtTaskTree::Storage<StorageStruct> &storage) | |
| GroupItem(std::initializer_list<QtTaskTree::GroupItem> children) | |
| GroupItem(QtTaskTree::GroupItem &&other) |
Descripción detallada
GroupItem es un elemento básico que puede formar parte de cualquier objeto de tipo « Group ». Encapsula la funcionalidad proporcionada por cualquier subclase de GroupItem. Es un tipo de valor y es seguro copiar la instancia de GroupItem, incluso cuando se haya creado originalmente mediante el constructor de la subclase.
Existen cuatro tipos principales de GroupItem:
| GroupItem Tipo | Breve descripción |
|---|---|
| QCustomTask | Define el tipo de tarea asíncrona y los controladores de inicio, finalización y error de la tarea. Se identifica con un nombre de tarea único, como, por ejemplo, QThreadFunctionTask<ResultType> o QNetworkReplyWrapperTask. Las tareas asíncronas son la razón principal para utilizar un árbol de tareas. |
| Group | Un contenedor para otros elementos de grupo. Dado que el grupo es de tipo GroupItem, es posible anidarlo dentro de otro grupo. El grupo es visto por su padre como una única tarea asíncrona. |
| GroupItem que contiene Storage | Permite que las tareas secundarias de un grupo intercambien datos. Cuando se coloca un `GroupItem` que contiene un ` Storage ` dentro de un grupo, el árbol de tareas instancia el objeto de datos del almacenamiento justo antes de entrar en el grupo y lo destruye justo después de salir de él. |
| Otros elementos de control de grupo | El ` ExecutionMode ` o los elementos devueltos por ` workflowPolicy()` influyen en el comportamiento del grupo. Los elementos devueltos por ` onGroupSetup()` o ` onGroupDone()` definen controladores personalizados que se invocan cuando el grupo inicia o finaliza su ejecución. |
Documentación sobre los tipos de miembros
[alias] GroupItem::GroupDoneHandler
Alias de tipo para ` std::function<DoneResult(DoneWith)> ` o ` DoneResult`.
GroupDoneHandler es un argumento del elemento onGroupDone(). Cualquier función con la firma anterior, cuando se pase como controlador de finalización de grupo, será llamada por el árbol de tareas en ejecución cuando finalice la ejecución del grupo.
El argumento ` DoneWith ` es opcional y tu controlador de finalización puede omitirlo. Cuando se proporciona, contiene la información sobre el resultado final de un grupo que se comunicará a su padre.
El valor devuelto de ` DoneResult ` es opcional y su manejador puede devolver en su lugar ` void `. En este caso, el resultado final del grupo será igual al valor indicado por el argumento ` DoneWith `. Cuando el manejador devuelve el valor ` DoneResult `, el resultado final del grupo puede modificarse dentro del cuerpo del manejador `done` mediante el valor devuelto.
En el caso de un GroupDoneHandler del tipo DoneResult, no se ejecuta ningún tratamiento adicional y el grupo finaliza incondicionalmente con el valor pasado de DoneResult, ignorando la política de flujo de trabajo del grupo.
Véase también ` onGroupDone()`, ` GroupSetupHandler` y ` QCustomTask::TaskDoneHandler`.
[alias] GroupItem::GroupSetupHandler
Alias de tipo para ` std::function<SetupResult()>`.
GroupSetupHandler es un argumento del elemento onGroupSetup(). Cualquier función con la firma anterior, cuando se pase como controlador de configuración de grupo, será llamada por el árbol de tareas en ejecución cuando comience la ejecución del grupo.
El valor de retorno del controlador indica al grupo en ejecución cómo proceder una vez finalizada la invocación del controlador. El valor de retorno predeterminado de ` SetupResult::Continue ` indica al grupo que continúe ejecutándose, es decir, que comience a ejecutar sus tareas secundarias. El valor de retorno de ` SetupResult::StopWithSuccess ` o ` SetupResult::StopWithError ` indica al grupo que omita la ejecución de las tareas secundarias y finalice inmediatamente con éxito o con un error, respectivamente.
Cuando el tipo de retorno es SetupResult::StopWithSuccess o SetupResult::StopWithError, el controlador «done» del grupo (si se ha proporcionado) se invoca de forma sincrónica inmediatamente después.
Nota: Aunque el controlador de configuración del grupo devuelva StopWithSuccess o StopWithError, se invoca el controlador «done» del grupo. Este comportamiento difiere del del controlador «done» de la tarea y podría cambiar en el futuro.
El elemento « onGroupSetup()» también admite funciones en la forma abreviada « std::function<void()> », es decir, el valor de retorno es « void ». En este caso, se da por supuesto que el valor de retorno es « SetupResult::Continue ».
Véase también onGroupSetup(), GroupDoneHandler y QCustomTask::TaskSetupHandler.
Documentación de funciones miembro
GroupItem::GroupItem(const QtTaskTree::GroupItems &children)
Crea un elemento `GroupItem` con una lista dada de elementos ` children`.
Cuando el QTaskTree analiza este elemento GroupItem, simplemente lo sustituye por su children.
Este constructor resulta útil a la hora de crear un elemento « Group » con listas de elementos «GroupItem»:
static GroupItems getItems();
...
const Group root {
parallel,
finishAllAndSuccess,
getItems(), // GroupItems list is wrapped into a single GroupItem element
onGroupSetup(...),
onGroupDone(...)
};Si deseas crear un subárbol, utiliza en su lugar Group.
Nota: No confundas este `GroupItem` con el elemento ` Group `, ya que ` Group ` mantiene a sus hijos anidados tras ser analizado por el árbol de tareas, mientras que este `GroupItem` no lo hace.
Véase también Group.
template <typename StorageStruct> GroupItem::GroupItem(const QtTaskTree::Storage<StorageStruct> &storage)
Crea un elemento `GroupItem` que contiene el objeto ` storage `.
Cuando el árbol de tareas en ejecución accede al elemento ` Group ` que contiene este `GroupItem`, se crea dinámicamente una instancia de ` StorageStruct `.
Cuando se está a punto de salir de ese grupo tras su ejecución, se elimina el objeto ` StorageStruct ` instanciado previamente.
Se puede acceder a la instancia creada dinámicamente de ` StorageStruct ` desde el interior de cualquier cuerpo de controlador del elemento padre ` Group `, incluidos los grupos anidados y sus tareas, mediante los métodos ` Storage::operator->()`, ` Storage::operator*()` o ` Storage::activeStorage()`.
Véase también Storage.
GroupItem::GroupItem(std::initializer_list<QtTaskTree::GroupItem> children)
Esta es una función sobrecargada.
Véase también GroupItem(const QtTaskTree::GroupItems &children).
[constexpr noexcept default] GroupItem::GroupItem(QtTaskTree::GroupItem &&other)
Crea una instancia de ` GroupItem` 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.