QGeoRouteReply Class
Die Klasse QGeoRouteReply verwaltet einen Vorgang, der von einer Instanz von QGeoRoutingManager gestartet wurde. Mehr...
| Header: | #include <QGeoRouteReply> |
| qmake: | QT += location |
| Inherits: | QObject |
Öffentliche Typen
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, UnknownError } |
Öffentliche Funktionen
| 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 |
Signale
| void | aborted() |
| void | errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Geschützte Funktionen
| 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) |
Detaillierte Beschreibung
Instanzen von QGeoRouteReply verwalten den Zustand und die Ergebnisse dieser Operationen.
Die Methoden isFinished(), error() und errorString() liefern Informationen darüber, ob die Operation abgeschlossen wurde und ob sie erfolgreich abgeschlossen wurde.
Die Signale finished() und errorOccurred(QGeoRouteReply::Error,QString) können verwendet werden, um den Fortschritt des Vorgangs zu überwachen.
Es ist möglich, dass eine neu erstellte QGeoRouteReply sich in einem beendeten Zustand befindet, meist weil ein Fehler aufgetreten ist. Da eine solche Instanz niemals die Signale finished() oder errorOccurred(QGeoRouteReply::Error,QString) ausgeben wird, ist es wichtig, das Ergebnis von isFinished() zu überprüfen, bevor die Verbindungen zu den Signalen hergestellt werden. Die Dokumentation für QGeoRoutingManager zeigt, wie dies durchgeführt werden kann.
Wenn die Operation erfolgreich abgeschlossen wurde, können die Ergebnisse mit routes() abgerufen werden.
Dokumentation der Mitgliedstypen
enum QGeoRouteReply::Error
Beschreibt einen Fehler, der den Abschluss des Vorgangs verhindert hat.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoRouteReply::NoError | 0 | Es ist kein Fehler aufgetreten. |
QGeoRouteReply::EngineNotSetError | 1 | Dem verwendeten Routing-Manager war keine QGeoRoutingManagerEngine -Instanz zugeordnet. |
QGeoRouteReply::CommunicationError | 2 | Bei der Kommunikation mit dem Dienstanbieter ist ein Fehler aufgetreten. |
QGeoRouteReply::ParseError | 3 | Die Antwort des Dienstanbieters lag in einem nicht erkennbaren Format vor. |
QGeoRouteReply::UnsupportedOptionError | 4 | Der angeforderte Vorgang oder eine der Optionen für den Vorgang wird vom Dienstanbieter nicht unterstützt. |
QGeoRouteReply::UnknownError | 5 | Es ist ein Fehler aufgetreten, der in keine der anderen Kategorien passt. |
Dokumentation der Mitgliedsfunktionen
[explicit protected] QGeoRouteReply::QGeoRouteReply(const QGeoRouteRequest &request, QObject *parent = nullptr)
Konstruiert ein Route-Reply-Objekt auf der Basis von request mit dem angegebenen parent.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
Konstruiert eine Routenantwort mit einem gegebenen error und errorString und dem angegebenen parent.
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
Zerstört dieses Routenantwortobjekt.
[virtual] void QGeoRouteReply::abort()
Bricht den Vorgang sofort ab.
Dies bewirkt nichts, wenn die Antwort beendet ist.
[signal] void QGeoRouteReply::aborted()
Dieses Signal wird ausgegeben, wenn der Vorgang abgebrochen wurde.
Siehe auch abort().
[protected] void QGeoRouteReply::addRoutes(const QList<QGeoRoute> &routes)
Fügt die Liste von routes an die bestehende Liste an.
QGeoRouteReply::Error QGeoRouteReply::error() const
Gibt den Fehlerstatus dieser Antwort zurück.
Wenn das Ergebnis QGeoRouteReply::NoError lautet, ist kein Fehler aufgetreten.
Siehe auch setError().
[signal] void QGeoRouteReply::errorOccurred(QGeoRouteReply::Error error, const QString &errorString = QString())
Dieses Signal wird ausgegeben, wenn bei der Verarbeitung dieser Antwort ein Fehler festgestellt wurde. Wahrscheinlich wird das Signal finished() folgen.
Der Fehler wird durch den Fehlercode error beschrieben. Wenn errorString nicht leer ist, enthält es eine textuelle Beschreibung des Fehlers.
Dieses Signal und QGeoRoutingManager::errorOccurred() werden zur gleichen Zeit ausgegeben.
Hinweis: Löschen Sie dieses Antwortobjekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().
QString QGeoRouteReply::errorString() const
Gibt die textuelle Darstellung des Fehlerstatus dieser Antwort zurück.
Wenn kein Fehler aufgetreten ist, wird ein leerer String zurückgegeben. Es ist möglich, dass ein Fehler aufgetreten ist, der keine zugehörige textuelle Darstellung hat; in diesem Fall wird ebenfalls eine leere Zeichenkette zurückgegeben.
Um festzustellen, ob ein Fehler aufgetreten ist, prüfen Sie, ob QGeoRouteReply::error() gleich QGeoRouteReply::NoError ist.
[signal] void QGeoRouteReply::finished()
Dieses Signal wird ausgegeben, wenn die Verarbeitung dieser Antwort abgeschlossen ist.
Wenn error() gleich QGeoRouteReply::NoError ist, wurde die Verarbeitung erfolgreich abgeschlossen.
Dieses Signal und QGeoRoutingManager::finished() werden zur gleichen Zeit ausgegeben.
Hinweis: Löschen Sie dieses Antwortobjekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().
Siehe auch setFinished().
bool QGeoRouteReply::isFinished() const
Gibt true zurück, wenn der Vorgang erfolgreich abgeschlossen wurde oder ein Fehler aufgetreten ist, der zum Abbruch des Vorgangs geführt hat.
QGeoRouteRequest QGeoRouteReply::request() const
Gibt die Routenanfrage zurück, die die Route spezifiziert hat.
QList<QGeoRoute> QGeoRouteReply::routes() const
Gibt die Liste der angeforderten Routen zurück.
Siehe auch setRoutes().
[protected] void QGeoRouteReply::setError(QGeoRouteReply::Error error, const QString &errorString)
Setzt den Fehlerstatus dieser Antwort auf error und die textuelle Darstellung des Fehlers auf errorString.
Dies führt auch dazu, dass die Signale errorOccurred() und finished() in dieser Reihenfolge ausgegeben werden.
Siehe auch error().
[protected] void QGeoRouteReply::setFinished(bool finished)
Legt fest, ob diese Antwort an finished beendet ist oder nicht.
Wenn finished wahr ist, wird das Signal finished() ausgegeben.
Wenn der Vorgang erfolgreich abgeschlossen wurde, sollte QGeoRouteReply::setRoutes() vor dieser Funktion aufgerufen werden. Ist ein Fehler aufgetreten, sollte stattdessen QGeoRouteReply::setError() verwendet werden.
Siehe auch finished().
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
Setzt die Liste der Routen in der Antwort auf routes.
Siehe auch routes().
© 2025 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.
