Obsolete Members for QFutureWatcher

QFutureWatcher 类的以下成员已被废弃。提供这些成员是为了确保旧源代码能够继续运行。我们强烈建议不要在新代码中使用它们。

公共函数

(deprecated in 6.0) bool isPaused() const

公共槽

(deprecated in 6.0) void pause()
(deprecated in 6.0) void setPaused(bool paused)
(deprecated in 6.0) void togglePaused()

信号

(deprecated in 6.0) void paused()

成员函数文档

[deprecated in 6.0] bool QFutureWatcher::isPaused() const

自 6.0 版本起,此函数已被废弃。我们强烈建议不要在新代码中使用它。

请改用 `isSuspending()` 或 `isSuspended()`。

如果异步计算已被 `pause()` 函数暂停,则返回 `true `;否则返回 `false`。

请注意,即使该函数返回true ,计算仍可能仍在运行。更多详情请参阅setPaused()。若要检查暂停是否已生效,请改用isSuspended()。

另请参阅 setSuspended()、toggleSuspended() 以及isSuspended()。

[slot, deprecated in 6.0] void QFutureWatcher::pause()

自 6.0 版本起,此函数已被废弃。我们强烈建议不要在新代码中使用它。

请改用 `suspend()`。

暂停由future() 表示的异步计算。这是一个便捷方法,仅调用setPaused(true)。

另请参阅 resume()。

[signal, deprecated in 6.0] void QFutureWatcher::paused()

自 6.0 起,此函数已被废弃。我们强烈建议不要在新代码中使用它。

请改用 `suspending()`。

当被监视的未来对象的状态被设置为“暂停”时,会发出此信号。

注意:此 信号仅通知已请求暂停。它并不表示所有后台操作都已停止。暂停时正在进行的计算相关的信号仍会发出。若要在pause()实际生效时收到通知,请使用suspended()信号。

另请参阅 setPaused()、setSuspended()、suspend() 和suspended()。

[slot, deprecated in 6.0] void QFutureWatcher::setPaused(bool paused)

自 6.0 版本起,该函数已被废弃。我们强烈建议不要在新代码中使用它。

请改用setSuspended()。

如果 `paused ` 为真,则该函数将暂停由 `future()` 表示的异步计算。如果计算已处于暂停状态,则该函数不执行任何操作。当未来对象被暂停时,`QFutureWatcher ` 不会立即停止发送进度和结果就绪信号。在暂停的瞬间,可能仍有正在进行的计算无法被停止。 此类计算产生的信号在暂停后仍会继续被分发。

如果paused 为 false,则该函数将恢复异步计算。如果计算此前未被暂停,则该函数不执行任何操作。

请注意,并非所有计算都可以被暂停。例如,QtConcurrent::run() 返回的QFuture 无法被暂停;但 QtConcurrent::mappedReduced() 返回的QFuture 则可以被暂停。

另请参阅 paused()、suspend()、resume() 和toggleSuspended()。

[slot, deprecated in 6.0] void QFutureWatcher::togglePaused()

自 6.0 版本起,此函数已被废弃。我们强烈建议不要在新代码中使用它。

请改用toggleSuspended()。

切换异步计算的暂停状态。换言之,如果计算当前处于暂停状态,调用此函数将恢复计算;如果计算正在运行,则将其暂停。这是一个用于调用 `setPaused(!isPaused())` 的便捷方法。

另请参阅 setSuspended()、suspend() 和resume()。

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