QQuickItemGrabResult Class
L'objet `QQuickItemGrabResult` contient le résultat de la fonction ` QQuickItem::grabToImage()`. En savoir 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érite de : | 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() |
Voir aussi QQuickItem::grabToImage().
Documentation des propriétés
[read-only] image : const QImage
Cette propriété contient les pixels obtenus à la suite d'une capture.
Si la capture n'est pas encore terminée ou si elle a échoué, une image nulle est renvoyée (la fonction `image.isNull() ` renverra ` true`).
Fonctions d'accès :
| QImage | image() const |
[read-only] url : const QUrl
Cette propriété contient une URL pouvant être utilisée avec des composants d'affichage d'images basés sur une URL, tels que le type QtQuick::Image.
L'URL reste valide jusqu'à la suppression de l'objet QQuickItemGrabResult.
L'URL ne correspond pas à un fichier valide ni à un emplacement à partir duquel le lire ; il s'agit avant tout d'une clé permettant d'accéder aux images via les types basés sur des images d'Qt Quick.
Fonctions d'accès :
| QUrl | url() const |
Documentation sur les fonctions membres
[signal] void QQuickItemGrabResult::ready()
Ce signal est émis lorsque la prise est terminée.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
Enregistre le résultat de la capture sous forme d'image à l'adresse fileName. Renvoie true en cas de succès ; sinon, renvoie false.
Remarque : dans les versions de Qt antérieures à la version 5.9, cette fonction est marquée comme non-const.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
Enregistre le résultat de la capture sous forme d'image à l'adresse filePath, qui doit correspondre à un fichier local file name portant l'extension supported image format. Renvoie true en cas de succès ; sinon, renvoie false.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis 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.
