QGeoRouteReply Class
La classe QGeoRouteReply gère une opération lancée par une instance de QGeoRoutingManager. Plus...
| Header: | #include <QGeoRouteReply> |
| qmake: | QT += location |
| Inherits: | QObject |
Types publics
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, UnknownError } |
Fonctions publiques
| QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr) | |
| virtual | ~QGeoRouteReply() |
| virtual void | abort() |
| QGeoRouteReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| QGeoRouteRequest | request() const |
| QList<QGeoRoute> | routes() const |
Signaux
| void | aborted() |
| void | errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Fonctions protégées
| QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr) | |
| void | addRoutes(const QList<QGeoRoute> &routes) |
| void | setError(QGeoRouteReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setRoutes(const QList<QGeoRoute> &routes) |
Description détaillée
Les instances de QGeoRouteReply gèrent l'état et les résultats de ces opérations.
Les méthodes isFinished(), error() et errorString() indiquent si l'opération est terminée et si elle s'est déroulée avec succès.
Les signaux finished() et errorOccurred(QGeoRouteReply::Error,QString) peuvent être utilisés pour surveiller la progression de l'opération.
Il est possible qu'un QGeoRouteReply nouvellement créé soit dans un état terminé, le plus souvent parce qu'une erreur s'est produite. Comme une telle instance n'émettra jamais les signaux finished() ou errorOccurred(QGeoRouteReply::Error,QString), il est important de vérifier le résultat de isFinished() avant d'établir les connexions avec les signaux. La documentation relative à QGeoRoutingManager montre comment procéder.
Si l'opération se termine avec succès, les résultats seront accessibles avec routes().
Documentation sur les types de membres
enum QGeoRouteReply::Error
Décrit une erreur qui a empêché l'achèvement de l'opération.
| Constante | Valeur | Description de l'erreur |
|---|---|---|
QGeoRouteReply::NoError | 0 | Aucune erreur n'est survenue. |
QGeoRouteReply::EngineNotSetError | 1 | Le gestionnaire de routage utilisé n'était pas associé à une instance QGeoRoutingManagerEngine. |
QGeoRouteReply::CommunicationError | 2 | Une erreur s'est produite lors de la communication avec le fournisseur de services. |
QGeoRouteReply::ParseError | 3 | La réponse du fournisseur de services était dans un format non reconnaissable. |
QGeoRouteReply::UnsupportedOptionError | 4 | L'opération demandée ou l'une des options de l'opération n'est pas prise en charge par le fournisseur de services. |
QGeoRouteReply::UnknownError | 5 | Une erreur s'est produite qui n'entre dans aucune des autres catégories. |
Documentation des fonctions membres
[explicit protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)
Construit un objet de réponse à l'itinéraire basé sur request, avec l'adresse parent spécifiée.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
Construit une réponse à l'itinéraire avec un error et un errorString donnés et le parent spécifié.
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
Détruit cet objet de réponse d'itinéraire.
[virtual] void QGeoRouteReply::abort()
Annule l'opération immédiatement.
Cela n'aura aucun effet si la réponse est terminée.
[signal] void QGeoRouteReply::aborted()
Ce signal est émis lorsque l'opération a été annulée.
Voir également abort().
[protected] void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)
Ajoute la liste de routes à la liste existante.
QGeoRouteReply::Error QGeoRouteReply::error() const
Renvoie l'état d'erreur de cette réponse.
Si le résultat est QGeoRouteReply::NoError, aucune erreur ne s'est produite.
Voir aussi setError().
[signal] void QGeoRouteReply::errorOccurred(QGeoRouteReply::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.
Ce signal et QGeoRoutingManager::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 QGeoRouteReply::errorString() const
Renvoie la représentation textuelle de l'état d'erreur de cette réponse.
Si aucune erreur ne s'est produite, le message renvoie une chaîne vide. Il est possible qu'une erreur se soit produite et qu'elle n'ait pas de représentation textuelle associée, auquel cas la réponse renverra également une chaîne vide.
Pour déterminer si une erreur s'est produite, il faut vérifier si QGeoRouteReply::error() est égal à QGeoRouteReply::NoError.
[signal] void QGeoRouteReply::finished()
Ce signal est émis lorsque le traitement de la réponse est terminé.
Si error() est égal à QGeoRouteReply::NoError, le traitement s'est terminé avec succès.
Ce signal et QGeoRoutingManager::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 QGeoRouteReply::isFinished() const
Retourne vrai si l'opération s'est terminée avec succès ou si elle a rencontré une erreur qui a entraîné l'arrêt de l'opération.
QGeoRouteRequest QGeoRouteReply::request() const
Renvoie la demande d'itinéraire qui a spécifié l'itinéraire.
QList<QGeoRoute> QGeoRouteReply::routes() const
Renvoie la liste des itinéraires qui ont été demandés.
Voir aussi setRoutes().
[protected] void QGeoRouteReply::setError(QGeoRouteReply::Error error, const QString &errorString)
Définit l'état d'erreur de cette réponse à error et la représentation textuelle de l'erreur à errorString.
Cela provoquera également l'émission des signaux errorOccurred() et finished(), dans cet ordre.
Voir aussi error().
[protected] void QGeoRouteReply::setFinished(bool finished)
Indique si la réponse est terminée ou non à finished.
Si finished est vrai, le signal finished() sera émis.
Si l'opération s'est terminée avec succès, QGeoRouteReply::setRoutes() doit être appelé avant cette fonction. Si une erreur s'est produite, QGeoRouteReply::setError() doit être utilisé à la place.
Voir aussi finished().
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
Définit la liste des itinéraires dans la réponse à routes.
Voir aussi routes().
© 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.
