QtTaskTree::QTaskInterface Class

class QtTaskTree::QTaskInterface

QTaskInterface 是一个辅助类，用于调整自定义任务的界面。更多

头文件：	`#include <qtasktree.h>`
CMake：	`find_package(Qt6 REQUIRED COMPONENTS TaskTree)` `target_link_libraries(mytarget PRIVATE Qt6::TaskTree)`
qmake：	`QT += tasktree`
自	Qt 6.11
继承：	QObject

所有成员的列表，包括继承成员

注意：该类中的所有函数都是可重入的。

公共函数

void	reportDone(QtTaskTree::DoneResult result)

重实现的受保护函数

virtual bool event(QEvent *event) override

详细说明

QCustomTask<Task,Adapter,Deleter> 模板的自定义Adapter 类型在适配 Worker 任务时应具有以下形式：

class WorkerTaskAdapter
{
public:
    void operator()(Worker *task, QTaskInterface *iface) { ... }
};

using WorkerTask = QCustomTask<Worker, WorkerTaskAdapter>;

成员函数文档

`[override virtual protected]` bool QTaskInterface::event(QEvent **event*)

重实现：QObject::event(QEvent *e)。

void QTaskInterface::reportDone(QtTaskTree::DoneResult result)

当通过自定义适配器适配的任务完成时，应调用该方法，并传递任务执行的result 。

假定 Worker 发出 finished(bool) 信号，适配器可能如下所示：

class WorkerTaskAdapter
{
public:
    void operator()(Worker *task, QTaskInterface *iface) {
        connect(task, &Worker::finished, iface, [iface](bool success) {
            iface->reportDone(toDoneResult(success));
        });
        task->execute();
    }
};

using WorkerTask = QCustomTask<Worker, WorkerTaskAdapter>;

另请参见 QCustomTask 。

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