46 lines
863 B
Markdown
46 lines
863 B
Markdown
|
# TaskGroup::Cancel
|
||
|
|
|
||
|
|
```cpp
|
||
|
|
void Cancel()
|
||
|
|
```
|
||
|
|
|
||
|
|
取消任务组中所有尚未执行的任务。正在执行的任务将不受影响。
|
||
|
|
|
||
|
|
**参数：** 无
|
||
|
|
|
||
|
|
**返回：** 无
|
||
|
|
|
||
|
|
**复杂度：** O(1)
|
||
|
|
|
||
|
|
**注意：**
|
||
|
|
- 已完成的任务不受影响。
|
||
|
|
- 正在执行的任务继续执行直到完成。
|
||
|
|
- 调用后所有 Wait/WaitFor 会立即返回。
|
||
|
|
|
||
|
|
**示例：**
|
||
|
|
|
||
|
|
```cpp
|
||
|
|
TaskGroup* group = TaskSystem::Get().CreateTaskGroup();
|
||
|
|
|
||
|
|
for (int i = 0; i < 100; ++i) {
|
||
|
|
group->AddTask([i]() {
|
||
|
|
if (ShouldCancel()) {
|
||
|
|
return; // 检查取消状态
|
||
|
|
}
|
||
|
|
ProcessLongTask(i);
|
||
|
|
});
|
||
|
|
}
|
||
|
|
|
||
|
|
// 如果用户点击取消按钮
|
||
|
|
if (userClickedCancel) {
|
||
|
|
group->Cancel();
|
||
|
|
printf("Tasks canceled. Progress: %.1f%%\n", group->GetProgress() * 100.0f);
|
||
|
|
}
|
||
|
|
|
||
|
|
group->Wait();
|
||
|
|
```
|
||
|
|
|
||
|
|
## 相关文档
|
||
|
|
|
||
|
|
- [TaskGroup 总览](task-group.md) - 返回类总览
|