Sur cette page

QQuickItemGrabResult Class

Le QQuickItemGrabResult contient le résultat de QQuickItem::grabToImage(). Plus...

En-tête : #include <QQuickItemGrabResult>
CMake : find_package(Qt6 REQUIRED COMPONENTS Quick)
target_link_libraries(mytarget PRIVATE Qt6::Quick)
qmake : QT += quick
En QML : ItemGrabResult
Héritages : QObject

Propriétés

Fonctions publiques

QImage image() const
bool saveToFile(const QString &fileName) const
(since 6.2) bool saveToFile(const QUrl &filePath) const
QUrl url() const

Signaux

void ready()

Description détaillée

Voir aussi QQuickItem::grabToImage().

Documentation sur les propriétés

[read-only] image : const QImage

Cette propriété contient les résultats en pixels d'une saisie.

Si la saisie n'est pas encore terminée ou si elle a échoué, une image nulle est renvoyée (image.isNull() renvoie true).

Fonctions d'accès :

QImage image() const

[read-only] url : const QUrl

Cette propriété contient une URL qui peut être utilisée avec des consommateurs d'images basés sur l'URL, tels que le type QtQuick::Image.

L'URL est valide jusqu'à ce que l'objet QQuickItemGrabResult soit supprimé.

L'URL ne représente pas un fichier ou un emplacement valide à partir duquel elle peut être lue. Il s'agit principalement d'une clé permettant d'accéder aux images par l'intermédiaire des types basés sur les images de Qt Quick.

Fonctions d'accès :

QUrl url() const

Documentation des fonctions membres

[signal] void QQuickItemGrabResult::ready()

Ce signal est émis lorsque la saisie est terminée.

[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const

Enregistre le résultat de la saisie sous forme d'image à l'adresse fileName. Renvoie true en cas de succès, sinon false.

Note : Dans les versions de Qt antérieures à 5.9, cette fonction est marquée comme nonconst.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const

Enregistre le résultat de la saisie sous forme d'image à l'adresse filePath, qui doit faire référence à une adresse local file name avec une extension supported image format. Renvoie true en cas de succès, sinon false.

Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

Cette fonction a été introduite dans 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.