QQuickImageResponse Class
La classe QQuickImageResponse fournit une interface permettant le chargement asynchrone d'images dans QQuickAsyncImageProvider. En savoir plus...
| En-tête : | #include <QQuickImageResponse> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Quick) target_link_libraries(mytarget PRIVATE Qt6::Quick) |
| qmake : | QT += quick |
| Hérite de : | QObject |
Fonctions publiques
| QQuickImageResponse() | |
| virtual | ~QQuickImageResponse() override |
| virtual QString | errorString() const |
| virtual QQuickTextureFactory * | textureFactory() const = 0 |
Slots publics
| virtual void | cancel() |
Signaux
| void | finished() |
Description détaillée
Une réponse d’image a pour but 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.
Consultez 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 d'image
[override virtual noexcept] QQuickImageResponse::~QQuickImageResponse()
Supprime la réponse d'image
[virtual slot] void QQuickImageResponse::cancel()
Cette méthode sert à indiquer que la réponse n'est plus nécessaire pour le moteur.
Elle peut être réimplémentée pour annuler une requête côté fournisseur, mais ce n’est pas obligatoire.
Une QQuickImageResponse annulée doit tout de même émettre finished() afin que le moteur puisse nettoyer l'QQuickImageResponse.
Remarque : la méthode finished() ne doit pas être appelée tant que la réponse n’est pas terminée, que la méthode cancel() ait été appelée ou non. Si elle est appelée prématurément, le moteur risque de détruire la réponse alors qu’elle est encore active, ce qui peut entraîner un plantage.
[virtual] QString QQuickImageResponse::errorString() const
Renvoie la chaîne d'erreur correspondant à l'exécution de la tâche. Une chaîne vide indique qu'aucune erreur ne s'est produite.
[signal] void QQuickImageResponse::finished()
Signale que l'exécution de la tâche est terminée (que ce soit avec succès, en raison d'une erreur ou parce qu'elle a été annulée).
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 l'instance de la fabrique de textures pour la tâche. Vous pouvez utiliser ` QQuickTextureFactory::textureFactoryForImage ` si votre fournisseur fonctionne avec ` QImage`. Le moteur prend en charge l'instance ` QQuickTextureFactory` renvoyée.
Remarque : cette méthode n'est appelée qu'en cas de besoin. Par exemple, elle peut ne pas être appelée en cas d'erreur ou si la tâche est annulée. Par conséquent, allouez l'instance QQuickTextureFactory uniquement dans cette méthode ou assurez-vous de la supprimer par d'autres moyens.
© 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.
