QGeoRouteReply Class
La classe `QGeoRouteReply` gère une opération lancée par une instance de ` QGeoRoutingManager`. En savoir 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 s'est terminée et si elle s'est déroulée avec succès.
Les signaux finished() et errorOccurred(QGeoRouteReply::Error,QString) permettent de suivre la progression de l’opération.
Il est possible qu’un objet `QGeoRouteReply` nouvellement créé se trouve déjà dans un état « terminé », le plus souvent en raison d’une erreur. Étant donné qu’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 vers ces signaux. La documentation relative à ` QGeoRoutingManager ` montre comment procéder.
Si l'opération aboutit, les résultats seront accessibles via la fonction ` routes()`.
Documentation sur les types de membres
enum QGeoRouteReply::Error
Décrit une erreur qui a empêché la réalisation de l'opération.
| Constante | Valeur | Description |
|---|---|---|
QGeoRouteReply::NoError | 0 | Aucune erreur ne s’est produite. |
QGeoRouteReply::EngineNotSetError | 1 | Le gestionnaire de routage utilisé n'était pas associé à une instance d'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 cette 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)
Crée un objet de réponse d'itinéraire à partir de request, en utilisant l'parent spécifiée.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
Crée une réponse d'itinéraire à partir d'une adresse de départ ( error ) et d'une adresse d'arrivée ( errorString ) données, ainsi que de l'adresse de destination spécifiée ( parent).
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
Supprime cet objet de réponse de route.
[virtual] void QGeoRouteReply::abort()
Annule immédiatement l'opération.
Cette opération n'aura aucun effet si la réponse est déjà 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 des « 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 », cela signifie qu'aucune erreur ne s'est produite.
Voir également setError().
[signal] void QGeoRouteReply::errorOccurred(QGeoRouteReply::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.
Ce signal et QGeoRoutingManager::errorOccurred() seront émis simultanément.
Remarque : ne supprimez pas cet objet de réponse dans le slot lié à 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, cette fonction renvoie une chaîne vide. Il est possible qu'une erreur se soit produite sans qu'aucune représentation textuelle ne lui soit associée ; dans ce cas, cette fonction renvoie également une chaîne vide.
Pour déterminer si une erreur s'est produite, vérifiez si ` QGeoRouteReply::error()` est égal à ` QGeoRouteReply::NoError`.
[signal] void QGeoRouteReply::finished()
Ce signal est émis lorsque le traitement de cette réponse est terminé.
Si error() est égal à QGeoRouteReply::NoError, cela signifie que le traitement s'est terminé avec succès.
Ce signal et la méthode QGeoRoutingManager::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 QGeoRouteReply::isFinished() const
Renvoie « true » si l'opération s'est déroulée avec succès ou si une erreur est survenue, entraînant l'interruption de l'opération.
QGeoRouteRequest QGeoRouteReply::request() const
Renvoie la requête de routage 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 sur « error » et la représentation textuelle de l'erreur sur « errorString ».
Cela provoquera également l'émission des signaux ` errorOccurred()` et ` finished()`, dans cet ordre.
Voir également error().
[protected] void QGeoRouteReply::setFinished(bool finished)
Détermine si cette réponse à finished est terminée ou non.
Si finished est vrai, cela provoquera l'émission du signal finished().
Si l’opération s’est terminée avec succès, la fonction QGeoRouteReply::setRoutes() doit être appelée avant cette fonction. Si une erreur s’est produite, il convient d’utiliser QGeoRouteReply::setError() à la place.
Voir également finished().
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
Définit la liste des itinéraires dans la réponse à routes.
Voir également 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.
