En esta página

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()

Descripción detallada

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.