QQuickItemGrabResult Class
El objeto `QQuickItemGrabResult` contiene el resultado de la función ` QQuickItem::grabToImage()`. Más información...
| Cabecera: | #include <QQuickItemGrabResult> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| En QML: | ItemGrabResult |
| Heredan de: | 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 la propiedad
[read-only] image : const QImage
Esta propiedad contiene los resultados en píxeles de una captura.
Si la captura aún no se ha completado o 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 se puede utilizar junto con componentes que utilizan imágenes a partir de una 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 ni una ubicación desde la que leerlo; se trata principalmente de 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 las funciones miembro
[signal] void QQuickItemGrabResult::ready()
Esta señal se emite cuando la recogida ha finalizado.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
Guarda el resultado de la captura como una imagen en fileName. Devuelve true si se realiza correctamente; en caso contrario, devuelve false.
Nota: En las versiones de Qt anteriores a la 5.9, esta función está marcada como noconst.
Nota: Esta función se puede invocar 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 archivo local file name con la extensión supported image format. Devuelve true si se realiza correctamente; en caso contrario, devuelve false.
Nota: Esta función se puede invocar 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.