QPlaceReply Class
La classe QPlaceReply gère une opération lancée par une instance de QPlaceManager et sert de classe de base pour des réponses plus spécialisées. Plus d'informations...
| Header: | #include <QPlaceReply> |
| qmake: | QT += location |
| Inherits: | QObject |
| Inherited By: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply, and QPlaceSearchSuggestionReply |
Types publics
| enum | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| enum | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
Fonctions publiques
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
Emplacements publics
| virtual void | abort() |
Signaux
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Fonctions protégées
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
Description détaillée
La classe QPlaceReply et chacune de ses sous-classes spécialisées gèrent l'état et les résultats des opérations correspondantes. Le QPlaceReply lui-même est utilisé pour les opérations qui n'ont pas de résultats, c'est-à-dire qu'il est seulement nécessaire de savoir si l'opération a réussi ou échoué.
Le signal finished() peut être utilisé pour surveiller la progression d'une opération. Une fois l'opération terminée, les méthodes error() et errorString() permettent de savoir si l'opération s'est déroulée avec succès. En cas de succès, la réponse contiendra les résultats de l'opération, c'est-à-dire que chaque sous-classe disposera des fonctions appropriées pour récupérer les résultats d'une opération.
Voir également QPlaceManager.
Documentation sur les types de membres
enum QPlaceReply::Error
Décrit une erreur survenue au cours d'une opération.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QPlaceReply::NoError | 0 | Aucune erreur ne s'est produite |
QPlaceReply::PlaceDoesNotExistError | 1 | Un lieu spécifié n'a pas pu être trouvé |
QPlaceReply::CategoryDoesNotExistError | 2 | La catégorie spécifiée n'a pas été trouvée |
QPlaceReply::CommunicationError | 3 | Une erreur s'est produite lors de la communication avec le fournisseur de services. |
QPlaceReply::ParseError | 4 | La réponse du fournisseur de services ou un fichier d'importation était dans un format non reconnaissable. |
QPlaceReply::PermissionsError | 5 | L'opération a échoué en raison d'autorisations insuffisantes. |
QPlaceReply::UnsupportedError | 6 | L'opération n'était pas prise en charge par le fournisseur de services. |
QPlaceReply::BadArgumentError | 7 | . Un paramètre fourni n'était pas valide. |
QPlaceReply::CancelError | 8 | L'opération a été annulée. |
QPlaceReply::UnknownError | 9 | Une erreur s'est produite qui n'entre dans aucune des autres catégories. |
enum QPlaceReply::Type
Décrit le type de réponse.
| Constante | Valeur | Description de la réponse |
|---|---|---|
QPlaceReply::Reply | 0 | Il s'agit d'une réponse générique. |
QPlaceReply::DetailsReply | 1 | Il s'agit d'une réponse pour la récupération des détails d'un lieu. |
QPlaceReply::SearchReply | 2 | Il s'agit d'une réponse pour l'opération de recherche d'un lieu. |
QPlaceReply::SearchSuggestionReply | 3 | Il s'agit d'une réponse pour une opération de suggestion de recherche. |
QPlaceReply::ContentReply | 4 | Il s'agit d'une réponse pour le contenu associé à un lieu. |
QPlaceReply::IdReply | 5 | Il s'agit d'une réponse qui renvoie l'identifiant d'un lieu ou d'une catégorie. Généralement utilisée pour les opérations de sauvegarde et de suppression d'un lieu ou d'une catégorie. |
QPlaceReply::MatchReply | 6 | Réponse renvoyant des lieux correspondant à ceux d'un autre fournisseur. |
Documentation des fonctions membres
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Construit un objet de réponse avec un parent donné.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Détruit l'objet de la réponse.
[virtual slot] void QPlaceReply::abort()
Annule immédiatement l'opération.
Voir aussi aborted().
[signal] void QPlaceReply::aborted()
Ce signal est émis lorsque l'opération a été annulée.
Voir également abort().
[signal] void QPlaceReply::contentUpdated()
Ce signal est émis lorsque le contenu de cette réponse a été mis à jour. Selon le plugin, ce signal peut ne jamais être émis ou être émis plusieurs fois avant que QPlaceReply::finished() ne soit émis, car certains backends sont capables de renvoyer le contenu demandé de manière asynchrone et incrémentale.
Remarque : ne supprimez pas ou ne supprimez pas plus tard cet objet de réponse dans le slot connecté à ce signal. Ne le faites qu'à QPlaceReply::finished.
QPlaceReply::Error QPlaceReply::error() const
Renvoie le code d'erreur.
Voir aussi setError().
[signal] void QPlaceReply::errorOccurred(QPlaceReply::Error error, const QString &errorString = QString())
Ce signal est émis lorsqu'une erreur a été détectée dans le traitement de cette réponse. Le signal finished() suivra probablement.
L'erreur sera décrite par le code d'erreur error. Si errorString n'est pas vide, il contiendra une description textuelle de l'erreur destinée aux développeurs et non aux utilisateurs finaux.
Ce signal et QPlaceManager::errorOccurred() seront émis en même temps.
Remarque : ne supprimez pas cet objet de réponse dans le slot connecté à ce signal. Utilisez plutôt deleteLater().
QString QPlaceReply::errorString() const
Renvoie la chaîne d'erreur de la réponse. La chaîne d'erreur est destinée à être utilisée uniquement par les développeurs et ne doit pas être affichée à l'utilisateur final.
Si aucune erreur ne s'est produite, la chaîne est vide.
[signal] void QPlaceReply::finished()
Ce signal est émis lorsque le traitement de la réponse est terminé.
Si error() est égal à QPlaceReply::NoError, le traitement s'est terminé avec succès.
Ce signal et QPlaceManager::finished() seront émis en même temps.
Remarque : ne supprimez pas cet objet de réponse dans le slot connecté à ce signal. Utilisez plutôt deleteLater().
Voir aussi setFinished().
bool QPlaceReply::isFinished() const
Retourne true si la réponse est terminée.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
Définit les adresses error et errorString de la réponse. Cette fonction ne provoque pas l'émission du signal QPlaceReply::errorOccurred(QPlaceReply::Error, const QString &errorString).
Voir aussi error().
[protected] void QPlaceReply::setFinished(bool finished)
Indique si la réponse est finished ou non. Cette fonction n'entraîne pas l'émission du signal finished().
Voir aussi finished().
[virtual] QPlaceReply::Type QPlaceReply::type() const
Renvoie le type de la réponse.
© 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.
