QtTaskTree::ExecutableItem Class

成员函数文档

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withAccept(ObjectSignalGetter &&getter) const

返回this ExecutableItem 和信号等待器的副本。传入的getter 是一个函数，返回一个描述发射器及其等待信号的ObjectSignal 。在getter 内使用makeObjectSignal() 创建ObjectSignal 对象。

当this ExecutableItem 以错误结束时，返回的Group 会立即以错误结束，而无需等待等待者的信号。

当this ExecutableItem 成功结束时，返回的Group 不会立即结束，而是等待等待信号的发送。等待信号发出后，返回的Group 将成功完成。如果等待信号在this ExecutableItem 完成之前发送，等待阶段将被跳过，返回的Group 将同步完成。

当this ExecutableItem 即将启动时，会建立与等待者信号的连接。如果等待信号在此之前被触发，那么在this ExecutableItem 启动后就不会被注意到。

template <typename ObjectSignalGetter> QtTaskTree::Group ExecutableItem::withCancel(ObjectSignalGetter &&getter, std::initializer_list<QtTaskTree::GroupItem> postCancelRecipe = {}) const

使this ExecutableItem 的副本可以取消。传入的getter 是一个函数，返回一个描述发射器及其取消信号的ObjectSignal 。在getter 内使用makeObjectSignal() 创建ObjectSignal 对象。当取消信号发出时，this ExecutableItem 会被取消，一个可选提供的postCancelRecipe 会被执行，返回的 Group 会以错误结束。

当this ExecutableItem 在取消信号发出前结束时，返回的组会立即结束，其结果与this ExecutableItem 结束时的结果相同。在这种情况下，可选提供的postCancelRecipe 会被跳过。

与取消信号的连接是在this ExecutableItem 即将启动时建立的。如果取消信号在此之前已被触发，那么在this ExecutableItem 启动后就不会被注意到。

QtTaskTree::Group ExecutableItem::withLog(const QString &logName) const

将自定义调试打印输出附加到this ExecutableItem 的副本，在任务启动时和任务完成后发出，并返回耦合项。

调试打印输出包括事件（开始或结束）的时间戳和logName ，以便在调试日志中识别特定任务。

完成打印输出包含同步或异步执行、执行结果（DoneWith 枚举描述的值）以及以毫秒为单位的总执行时间等附加信息。

QtTaskTree::Group ExecutableItem::withTimeout(std::chrono::milliseconds timeout, const std::function<void ()> &handler = {}) const

将QTimeoutTask 附加到this ExecutableItem 的副本，以毫秒为单位经过timeout ，可选择提供超时时间handler ，并返回耦合项。

当ExecutableItem 在timeout 传递之前结束时，返回的项目会立即与任务结果一起结束。否则，将调用handler （如果提供），取消任务，并以错误结束返回项。