QQuickItemGrabResult Class
Das QQuickItemGrabResult enthält das Ergebnis von QQuickItem::grabToImage(). Mehr...
| Kopfzeile: | #include <QQuickItemGrabResult> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| In QML: | ItemGrabResult |
| Vererbt: | 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 der Eigenschaften
[read-only] image : const QImage
Diese Eigenschaft enthält die Pixelergebnisse einer Aufnahme.
Wenn die Erfassung noch nicht abgeschlossen ist oder fehlgeschlagen ist, wird ein Null-Bild 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 Bildkonsumenten, wie z.B. dem Typ QtQuick::Image, verwendet werden kann.
Die URL ist gültig, bis das QQuickItemGrabResult Objekt gelöscht wird.
Die URL steht nicht für eine gültige Datei oder einen Ort, von dem sie gelesen werden soll, sondern ist in erster Linie ein Schlüssel für den Zugriff auf Bilder über die bildbasierten Typen von Qt Quick.
Zugriffsfunktionen:
| QUrl | url() const |
Dokumentation der Mitgliedsfunktionen
[signal] void QQuickItemGrabResult::ready()
Dieses Signal wird ausgegeben, wenn der Greifvorgang abgeschlossen ist.
[invokable] bool QQuickItemGrabResult::saveToFile(const QString &fileName) const
Speichert das Grab-Ergebnis als Bild in fileName. Gibt bei Erfolg true zurück, andernfalls false.
Hinweis: In Qt-Versionen vor 5.9 ist diese Funktion als nichtconst gekennzeichnet.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable, since 6.2] bool QQuickItemGrabResult::saveToFile(const QUrl &filePath) const
Speichert das Grab-Ergebnis als Bild in filePath, das auf ein local file name mit der Erweiterung supported image format verweisen muss. Gibt bei Erfolg true zurück, andernfalls false.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Diese Funktion wurde in Qt 6.2 eingeführt.
© 2025 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.
