QQuickImageResponse 类
QQuickImageResponse 类提供了一个接口,用于在 QQuickAsyncImageProvider 中异步加载图像。更多...
头文件 | #include <QQuickImageResponse> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
qmake | QT += quick |
继承 | QObject |
公共函数
QQuickImageResponse() | |
虚拟 | ~QQuickImageResponse() 覆盖 |
虚拟 QString | errorString() 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 公司及其在全球的其他国家和地区的 商标。所有其他商标均属于其各自的所有者。