QQuickImageResponse Class
Die Klasse QQuickImageResponse bietet eine Schnittstelle zum asynchronen Laden von Bildern in QQuickAsyncImageProvider. Mehr...
| Kopfzeile: | #include <QQuickImageResponse> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Vererbt: | QObject |
Öffentliche Funktionen
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
Öffentliche Slots
| virtual void | cancel() |
Signale
| void | finished() |
Detaillierte Beschreibung
Der Zweck einer Bildantwort besteht darin, eine Möglichkeit zu schaffen, dass Bildanbieteraufträge asynchron ausgeführt werden können.
Antworten werden über deleteLater gelöscht, sobald das Signal finished() ausgegeben wurde. Wenn Sie QRunnable als Basis für Ihre QQuickImageResponse verwenden, stellen Sie sicher, dass die automatische Löschung deaktiviert ist.
Siehe das Image Response Provider-Beispiel für eine vollständige Implementierung.
Siehe auch QQuickImageProvider.
Dokumentation der Mitgliedsfunktionen
QQuickImageResponse::QQuickImageResponse()
Konstruiert die Bildantwort
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Zerstört die Bildantwort
[virtual slot] void QQuickImageResponse::cancel()
Diese Methode wird verwendet, um mitzuteilen, dass die Antwort von der Maschine nicht mehr benötigt wird.
Sie kann neu implementiert werden, um eine Anfrage auf der Anbieterseite abzubrechen, ist aber nicht zwingend erforderlich.
Eine abgebrochene QQuickImageResponse muss immer noch finished() aussenden, damit die Engine die QQuickImageResponse bereinigen kann.
Hinweis: finished() sollte nicht ausgegeben werden, bevor die Antwort vollständig ist, unabhängig davon, ob cancel() aufgerufen wurde oder nicht. Wenn es zu früh aufgerufen wird, kann die Engine die Antwort zerstören, während sie noch aktiv ist, was zu einem Absturz führt.
[virtual] QString QQuickImageResponse::errorString() const
Gibt die Fehlerzeichenfolge für die Auftragsausführung zurück. Ein leerer String bedeutet keinen Fehler.
[signal] void QQuickImageResponse::finished()
Signalisiert, dass die Auftragsausführung beendet ist (sei es erfolgreich, weil ein Fehler aufgetreten ist oder weil sie abgebrochen wurde).
Hinweis: Das Aussenden dieses Signals muss die letzte Aktion sein, die die Antwort ausführt: Sobald das Signal empfangen wurde, wird die Antwort anschließend von der Engine zerstört.
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
Gibt die Texturfabrik für den Auftrag zurück. Sie können QQuickTextureFactory::textureFactoryForImage verwenden, wenn Ihr Anbieter mit QImage arbeitet. Die Engine übernimmt das Eigentum an der zurückgegebenen QQuickTextureFactory.
Hinweis: Diese Methode wird nur aufgerufen, wenn sie benötigt wird. Sie wird zum Beispiel nicht aufgerufen, wenn ein Fehler auftritt oder der Auftrag abgebrochen wird. Weisen Sie daher die Instanz QQuickTextureFactory nur in dieser Methode zu oder sorgen Sie auf andere Weise für ihre Löschung.
© 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.
