QQuickItemGrabResult Class
El QQuickItemGrabResult contiene el resultado de QQuickItem::grabToImage(). Más...
| Cabecera: | #include <QQuickItemGrabResult> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| En QML: | ItemGrabResult |
| Hereda: | QObject |
Propiedades
Funciones públicas
| QImage | image() const |
| bool | saveToFile(const QString &fileName) const |
(since 6.2) bool | saveToFile(const QUrl &filePath) const |
| QUrl | url() const |
Señales
| void | ready() |
Véase también QQuickItem::grabToImage().
Documentación de propiedades
[read-only] image : const QImage
Esta propiedad contiene los resultados de píxeles de una captura.
Si la captura aún no se ha completado o si ha fallado, se devuelve una imagen nula (image.isNull() devolverá true).
Funciones de acceso:
| QImage | image() const |
[read-only] url : const QUrl
Esta propiedad contiene una URL que puede usarse junto con consumidores de imágenes basados en URL, como el tipo QtQuick::Image.
La URL es válida hasta que se elimine el objeto QQuickItemGrabResult.
La URL no representa un archivo válido o una localización desde la que leerla, es principalmente una clave para acceder a imágenes a través de los tipos basados en imágenes de Qt Quick.
Funciones de acceso:
| QUrl | url() const |
Documentación de funciones miembro
[signal] void QQuickItemGrabResult::ready()
Esta señal se emite cuando la captura se ha completado.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
Guarda el resultado de la captura como una imagen en fileName. Devuelve true si tiene éxito; en caso contrario devuelve false.
Nota: En versiones de Qt anteriores a la 5.9, esta función está marcada como noconst.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
Guarda el resultado de la captura como una imagen en filePath, que debe hacer referencia a un local file name con una extensión supported image format. Devuelve true si tiene éxito; en caso contrario devuelve false.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Esta función se introdujo en Qt 6.2.
© 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.
