QQuickItemGrabResult 类
QQuickItemGrabResult 包含从 QQuickItem::grabToImage() 返回的结果。更多...
| 头文件 | #include <QQuickItemGrabResult> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake | QT += quick |
| 由以下实例化 | ItemGrabResult |
| 继承 | QObject |
属性
公共函数
| QImage | image() const |
| bool | saveToFile(const QString &fileName) const |
(自 6.2) bool | saveToFile(const QUrl &filePath) const |
| QUrl | url() const |
信号
| void | ready() |
属性文档
[只读] image : const QImage
此属性包含从抓取获取的像素结果。
如果抓取尚未完成或失败，则返回空图像（image.isNull() 将返回 true）。
访问函数
| QImage | image() const |
[只读] url : const QUrl
此属性包含一个 URL，可以与基于 URL 的图像消费者（如 QtQuick::Image 类型）一起使用。
在整个 QQuickItemGrabResult 对象被删除之前，URL 是有效的。
URL 不代表有效的文件或读取它的位置，它是通过 Qt Quick 的图像类型的键访问图像的主要密钥。
访问函数
| QUrl | url() const |
成员函数文档
[信号] void QQuickItemGrabResult::ready()
当抓取完成时发出此信号。
[可调用] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
将抓取结果保存为图像到fileName。如果成功则返回true；否则返回false。
注意：在Qt 5.9之前的版本中，此函数被标记为非const。
注意：此函数可以通过元对象系统和QML调用。参见Q_INVOKABLE。
[可调用，自6.2版本起] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
将抓取结果保存为图像到filePath，它必须是指向具有本地文件名且具有支持的图像格式扩展名的文件。如果成功则返回true；否则返回false。
注意：此函数可以通过元对象系统和QML调用。参见Q_INVOKABLE。
此功能是在Qt 6.2版本中引入的。
© 2024 Qt公司。本文档中所包含的贡献归各自的拥有者所有。本文档遵守由自由软件基金会发布的GNU自由文档许可版本1.3条款。Qt及其相关标志是芬兰和/或其他国家/地区的Qt公司商标。所有其他商标都属于其各自的拥有者。
