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 在取消信号发出之前结束时，返回的 Group 将立即以与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 （如果已提供），任务将被取消，返回的项将以错误状态结束。