QQuickItemGrabResult Class
Das `QQuickItemGrabResult` enthält das Ergebnis von ` QQuickItem::grabToImage()`. Mehr...
| Header: | #include <QQuickItemGrabResult> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| In QML: | ItemGrabResult |
| Erbt von: | QObject |
Eigenschaften
Öffentliche Funktionen
| QImage | image() const |
| bool | saveToFile(const QString &fileName) const |
(since 6.2) bool | saveToFile(const QUrl &filePath) const |
| QUrl | url() const |
Signale
| void | ready() |
Siehe auch QQuickItem::grabToImage().
Dokumentation zu den Eigenschaften
[read-only] image : const QImage
Diese Eigenschaft enthält die Pixel-Ergebnisse eines Grab-Vorgangs.
Ist die Bildaufnahme noch nicht abgeschlossen oder ist sie fehlgeschlagen, wird ein Nullbild zurückgegeben (image.isNull() gibt „ true “ zurück).
Zugriffsfunktionen:
| QImage | image() const |
[read-only] url : const QUrl
Diese Eigenschaft enthält eine URL, die in Verbindung mit URL-basierten Bildkomponenten wie dem Typ `QtQuick::Image` verwendet werden kann.
Die URL ist gültig, bis das QQuickItemGrabResult -Objekt gelöscht wird.
Die URL stellt keine gültige Datei oder keinen gültigen Speicherort dar, von dem aus sie gelesen werden kann; sie dient in erster Linie als Schlüssel für den Zugriff auf Bilder über die bildbasierten Typen von ` Qt Quick`.
Zugriffsfunktionen:
| QUrl | url() const |
Dokumentation zu den Mitgliedsfunktionen
[signal] void QQuickItemGrabResult::ready()
Dieses Signal wird ausgegeben, wenn der Greifvorgang abgeschlossen ist.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
Speichert das Ergebnis des Bildausschnitts als Bild unter fileName. Gibt bei Erfolg true zurück; andernfalls wird false zurückgegeben.
Hinweis: In Qt-Versionen vor 5.9 ist diese Funktion als nicht-const gekennzeichnet.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe „ Q_INVOKABLE “.
[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
Speichert das Ergebnis des Bildausschnitts als Bild unter filePath, wobei es sich um einen local file name mit der Erweiterung supported image format handeln muss. Gibt bei Erfolg true zurück; andernfalls wird false zurückgegeben.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.2 eingeführt.
© 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.
