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. En savoir plus…
| 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 |
Slots 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. La classe QPlaceReply est utilisée pour les opérations qui ne produisent aucun résultat, c'est-à-dire pour lesquelles il suffit de savoir si l'opération a réussi ou échoué.
Le signal ` finished()` peut être utilisé pour suivre la progression d'une opération. Une fois l'opération terminée, les méthodes ` error()` et ` errorString()` indiquent 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 cette opération ; en effet, chaque sous-classe dispose de 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 |
|---|---|---|
QPlaceReply::NoError | 0 | Aucune erreur ne s'est produite |
QPlaceReply::PlaceDoesNotExistError | 1 | L'emplacement spécifié est introuvable |
QPlaceReply::CategoryDoesNotExistError | 2 | La catégorie spécifiée est introuvable |
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 d'un fichier d'importation était dans un format non reconnu |
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 |
|---|---|---|
QPlaceReply::Reply | 0 | Il s'agit d'une réponse générique. |
QPlaceReply::DetailsReply | 1 | Il s'agit d'une réponse relative à la récupération des détails d'un lieu |
QPlaceReply::SearchReply | 2 | Il s'agit d'une réponse à une opération de recherche de lieu. |
QPlaceReply::SearchSuggestionReply | 3 | Il s'agit d'une réponse à une opération de suggestion de recherche. |
QPlaceReply::ContentReply | 4 | Il s'agit d'une réponse concernant 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. Elle est généralement utilisée pour les opérations d'enregistrement et de suppression de lieux ou de catégories. |
QPlaceReply::MatchReply | 6 | Il s'agit d'une réponse qui renvoie les lieux correspondant à ceux d'un autre fournisseur. |
Documentation des fonctions membres
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Crée un objet de réponse à partir d'une adresse e- parent.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Supprime l'objet « reply ».
[virtual slot] void QPlaceReply::abort()
Annule immédiatement l'opération.
Voir également 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 cette réponse dispose d'un contenu mis à jour. Selon le plugin, ce signal peut ne jamais être émis ou l'être plusieurs fois avant que le signal ` QPlaceReply::finished()` ne soit émis, car certains backends sont capables de renvoyer le contenu demandé de manière asynchrone et par incréments.
Remarque : nesupprimez pas cet objet de réponse à l’aide de delete ou deleteLater dans le slot connecté à ce signal. Ne le faites qu’après l’émission de 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 lors du 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 simultanément.
Remarque : ne supprimez pas cet objet de réponse dans le slot lié à ce signal. Utilisez plutôt la fonction deleteLater().
QString QPlaceReply::errorString() const
Renvoie la chaîne d'erreur de la réponse. Cette chaîne d'erreur est destinée exclusivement aux 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 cette réponse est terminé.
Si error() est égal à QPlaceReply::NoError, cela signifie que le traitement s'est terminé avec succès.
Ce signal et la fonction QPlaceManager::finished() seront émis simultanément.
Remarque : ne supprimez pas cet objet de réponse dans le slot connecté à ce signal. Utilisez plutôt la fonction deleteLater().
Voir également setFinished().
bool QPlaceReply::isFinished() const
Renvoie « true » si la réponse est terminée.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
Définit les paramètres « error » et « errorString » de la réponse. Cette fonction ne provoque pas l'émission du signal « QPlaceReply::errorOccurred » (QPlaceReply::Error, const QString &errorString).
Voir également error().
[protected] void QPlaceReply::setFinished(bool finished)
Détermine si la réponse est de type « finished » ou non. Cette fonction ne déclenche pas le signal finished().
Voir également 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.
