QQuickImageResponse Class
La classe QQuickImageResponse fournit une interface pour le chargement asynchrone d'images dans QQuickAsyncImageProvider. Plus...
| En-tête : | #include <QQuickImageResponse> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick)target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Héritages : | QObject |
Fonctions publiques
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
Emplacements publics
| virtual void | cancel() |
Signaux
| void | finished() |
Description détaillée
L'objectif d'une réponse d'image est de permettre l'exécution asynchrone des tâches des fournisseurs d'images.
Les réponses sont supprimées via deleteLater une fois que le signal finished() a été émis. Si vous utilisez QRunnable comme base pour votre QQuickImageResponse, assurez-vous que la suppression automatique est désactivée.
Voir l'exemple de fournisseur de réponse d'image pour une implémentation complète.
Voir également QQuickImageProvider.
Documentation des fonctions membres
QQuickImageResponse::QQuickImageResponse()
Construit la réponse de l'image
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Détruit la réponse à l'image
[virtual slot] void QQuickImageResponse::cancel()
Cette méthode est utilisée pour indiquer que le moteur n'a plus besoin de la réponse.
Elle peut être réimplémentée pour annuler une demande du côté du fournisseur, mais elle n'est pas obligatoire.
Un QQuickImageResponse annulé doit toujours émettre finished() pour que le moteur puisse nettoyer le QQuickImageResponse.
Note : finished() ne doit pas être émis tant que la réponse n'est pas complète, que cancel() ait été appelé ou non. S'il est appelé prématurément, le moteur peut détruire la réponse alors qu'elle est encore active, ce qui entraîne un plantage.
[virtual] QString QQuickImageResponse::errorString() const
Renvoie la chaîne d'erreur pour l'exécution du travail. Une chaîne vide signifie qu'il n'y a pas d'erreur.
[signal] void QQuickImageResponse::finished()
Signale que l'exécution du travail est terminée (que ce soit avec succès, parce qu'une erreur s'est produite ou parce qu'il a été annulé).
Remarque : l'émission de ce signal doit être la dernière action effectuée par la réponse : une fois le signal reçu, la réponse sera ensuite détruite par le moteur.
[pure virtual] QQuickTextureFactory *QQuickImageResponse::textureFactory() const
Renvoie la fabrique de textures pour le travail. Vous pouvez utiliser QQuickTextureFactory::textureFactoryForImage si votre fournisseur fonctionne avec QImage. Le moteur est propriétaire de l'objet retourné QQuickTextureFactory.
Remarque : cette méthode n'est appelée qu'en cas de besoin. Par exemple, elle ne sera pas appelée en cas d'erreur ou d'annulation du travail. Par conséquent, n'allouez l'instance QQuickTextureFactory que dans cette méthode ou veillez à ce qu'elle soit supprimée.
© 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.
