PySide6.QtQuick.QQuickImageResponse

class QQuickImageResponse

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

PySide6.QtQuick.QQuickImageResponse的继承图

概要

方法

虚拟方法

信号

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题,您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述

图像响应的目的是为图像提供者作业提供一种异步执行的方式。

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

查看图像响应提供者示例以获取完整的实现。

另请参阅

QQuickImageProvider

__init__()

构建图像响应

cancel()

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

它可能会被重新实现以在提供者端取消请求,然而,这并不是强制性的。

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

注意

finished() 在响应完成之前不应被触发,无论是否调用了 cancel()。如果过早调用,引擎可能会在响应仍然活跃时销毁它,导致崩溃。

errorString()
Return type:

字符串

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

finished()

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

注意

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

abstract textureFactory()
Return type:

QQuickTextureFactory

返回作业的纹理工厂。如果您的提供者使用QImage,您可以使用textureFactoryForImage。引擎将拥有返回的QQuickTextureFactory的所有权。

注意

此方法仅在需要时调用。例如,如果出现错误或作业被取消,则可能不会调用此方法。因此,请仅在此方法中分配QQuickTextureFactory实例,或以其他方式确保其删除。