QQuickImageResponse Class
Die Klasse „QQuickImageResponse“ bietet eine Schnittstelle für das asynchrone Laden von Bildern in „ QQuickAsyncImageProvider “. Mehr...
| Header: | #include <QQuickImageResponse> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake: | QT += quick |
| Erbt von: | QObject |
Öffentliche Funktionen
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
Öffentliche Slots
| virtual void | cancel() |
Signale
| void | finished() |
Ausführliche Beschreibung
Der Zweck einer Bildantwort besteht darin, eine Möglichkeit zu bieten, Bildanbieter-Jobs asynchron auszuführen.
Antworten werden über „ deleteLater “ gelöscht, sobald das Signal „ finished()“ ausgelöst wurde. Wenn Sie „ QRunnable “ als Basis für Ihre „QQuickImageResponse“ verwenden, stellen Sie sicher, dass die automatische Löschung deaktiviert ist.
Eine vollständige Implementierung finden Sie im Beispiel „Image Response Provider “.
Siehe auch „ QQuickImageProvider “.
Dokumentation zu den Mitgliedsfunktionen
QQuickImageResponse::QQuickImageResponse()
Erstellt die Bildantwort
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Löscht die Bildantwort
[virtual slot] void QQuickImageResponse::cancel()
Diese Methode wird verwendet, um mitzuteilen, dass die Antwort von der Engine nicht mehr benötigt wird.
Sie kann neu implementiert werden, um eine Anfrage auf der Anbieterseite abzubrechen, ist jedoch nicht zwingend erforderlich.
Ein abgebrochener ` QQuickImageResponse ` muss dennoch ` finished()` auslösen, damit die Engine die ` QQuickImageResponse` bereinigen kann.
Hinweis: ` finished()` sollte erst aufgerufen werden, wenn die Antwort vollständig ist, unabhängig davon, ob `cancel()` aufgerufen wurde oder nicht. Wird die Methode vorzeitig aufgerufen, kann die Engine die Antwort zerstören, während diese noch aktiv ist, was zu einem Absturz führen kann.
[virtual] QString QQuickImageResponse::errorString() const
Gibt die Fehlerzeichenfolge für die Ausführung des Jobs zurück. Eine leere Zeichenfolge bedeutet, dass kein Fehler aufgetreten ist.
[signal] void QQuickImageResponse::finished()
Signalisiert, dass die Ausführung des Jobs abgeschlossen ist (sei es erfolgreich, aufgrund eines Fehlers oder weil er abgebrochen wurde).
Hinweis: Die Ausgabe 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 gelöscht.
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
Gibt die Textur-Factory für den Job zurück. Sie können ` QQuickTextureFactory::textureFactoryForImage ` verwenden, wenn Ihr Provider mit ` QImage` arbeitet. Die Engine übernimmt die Verantwortung für das zurückgegebene ` QQuickTextureFactory`.
Hinweis: Diese Methode wird nur bei Bedarf aufgerufen. Beispielsweise wird sie möglicherweise nicht aufgerufen, wenn ein Fehler auftritt oder der Auftrag abgebrochen wird. Weisen Sie die ` QQuickTextureFactory `-Instanz daher nur in dieser Methode zu oder stellen Sie anderweitig sicher, dass sie gelöscht wird.
© 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.
