QQuickImageResponse 类

QQuickImageResponse 类提供了一个接口,用于在 QQuickAsyncImageProvider 中异步加载图像。更多...

头文件 #include <QQuickImageResponse>
CMakefind_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmakeQT += quick
继承 QObject

公共函数

QQuickImageResponse()
虚拟~QQuickImageResponse() 覆盖
虚拟 QStringerrorString() const
虚拟 QQuickTextureFactory *textureFactory() const = 0

公共槽

虚拟 void取消()

信号

void完成()

详细描述

图像响应的目的是提供一种方法,以便在异步方式下执行图像提供者作业。

响应通过 deleteLater 删除,一旦发出 finished() 信号。如果您将 QRunnable 作为 QQuickImageResponse 的基类,请确保启用自动删除。

请参阅 Image Response Provider 示例 以获得完整的实现。

另请参阅 QQuickImageProvider

成员函数文档

QQuickImageResponse::QQuickImageResponse()

构建图像响应

[覆盖虚拟 noexcept] QQuickImageResponse::~QQuickImageResponse()

销毁图像响应

[虚拟槽] void QQuickImageResponse::cancel()

此方法用于通知引擎不再需要响应。

它可以重新实现来取消提供者侧的请求,但这不是必须的。

已取消的 QQuickImageResponse 仍需要发出 finished(),以便引擎可以清理 QQuickImageResponse

注意: finished() 应该在响应完成后再发出,无论是否调用 cancel()。如果提前调用,则在响应仍然处于活动状态时引擎可能会破坏响应,导致崩溃。

[虚拟] QString QQuickImageResponse::errorString() const

返回作业执行的错误字符串。空字符串表示没有错误。

[信号] void QQuickImageResponse::finished()

指示作业执行已完成(无论是成功完成、因为发生错误还是因为被取消)。

注意:发射此信号必须是响应执行的最终操作:一旦接收到信号,响应将被引擎销毁。

[纯虚函数] QQuickTextureFactory *QQuickImageResponse::textureFactory() const

返回用于作业的纹理工厂。如果你的提供者与 QImage 一起工作,则可以使用 QQuickTextureFactory::textureFactoryForImage。引擎将拥有所返回的 QQuickTextureFactory

注意:此方法仅在需要时调用。例如,如果发生错误或作业被取消,则可能不会调用。因此,只能在该方法中或以其他方式确保其删除的情况下分配该 QQuickTextureFactory 实例。

© 2024 Qt 公司有限。包含在此的文档贡献的版权属于其各自的所有者。此处提供的文档是根据自由软件基金会发布的 GNU 自由文档许可版本 1.3 许可的。Qt 及相关标志是芬兰的 Qt 公司及其在全球的其他国家和地区的 商标。所有其他商标均属于其各自的所有者。