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 Status und die Ergebnisse dieser Operationen.
Die Methoden „ isFinished()“, „ error()“ und „ errorString()“ geben Auskunft darüber, ob der Vorgang abgeschlossen wurde und ob er erfolgreich war.
Die Signale „ finished()“ und „ errorOccurred(QGeoRouteReply::Error,QString)“ können verwendet werden, um den Fortschritt des Vorgangs zu überwachen.
Es ist möglich, dass sich eine neu erstellte `QGeoRouteReply` bereits im Status „finished“ befindet, was meist darauf zurückzuführen ist, dass ein Fehler aufgetreten ist. Da eine solche Instanz niemals die Signale ` finished()` oder ` errorOccurred` (QGeoRouteReply::Error,QString) aussendet, ist es wichtig, das Ergebnis von ` isFinished()` zu überprüfen, bevor Verbindungen zu den Signalen hergestellt werden. Die Dokumentation zu ` QGeoRoutingManager ` veranschaulicht, wie dies umgesetzt werden kann.
Wenn der Vorgang erfolgreich abgeschlossen wurde, können die Ergebnisse mit ` routes()` abgerufen werden.
Dokumentation zu 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)
Erstellt ein Routenantwort-Objekt auf der Grundlage von request unter Verwendung der angegebenen parent.
[explicit] QGeoRouteReply::QGeoRouteReply(QGeoRouteReply::Error error, const QString &errorString, QObject *parent = nullptr)
Erstellt eine Routenantwort mit den angegebenen Werten für „ error “ und „ errorString “ sowie dem angegebenen „ parent “.
[virtual noexcept] QGeoRouteReply::~QGeoRouteReply()
Löscht dieses Route-Antwortobjekt.
[virtual] void QGeoRouteReply::abort()
Bricht den Vorgang sofort ab.
Dies hat keine Auswirkungen, wenn die Antwort bereits abgeschlossen 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 „ 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. Das Signal „ finished()“ wird wahrscheinlich darauf folgen.
Der Fehler wird durch den Fehlercode ` error` beschrieben. Ist ` errorString ` nicht leer, enthält es eine textuelle Beschreibung des Fehlers.
Dieses Signal und „ QGeoRoutingManager::errorOccurred()“ werden gleichzeitig ausgelöst.
Hinweis: LöschenSie 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 eine leere Zeichenkette zurückgegeben. Es ist möglich, dass ein Fehler aufgetreten ist, für den es keine zugehörige textuelle Darstellung gibt; 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 gleichzeitig ausgelöst.
Hinweis: LöschenSie 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 den Vorgang zum Abbruch geführt hat.
QGeoRouteRequest QGeoRouteReply::request() const
Gibt die Routenanfrage zurück, mit der die Route festgelegt wurde.
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 “.
Dadurch werden außerdem die Signale „ errorOccurred()“ und „ finished()“ in dieser Reihenfolge ausgelöst.
Siehe auch error().
[protected] void QGeoRouteReply::setFinished(bool finished)
Legt fest, ob diese Antwort an finished abgeschlossen ist oder nicht.
Ist ` finished ` wahr, wird das Signal ` finished()` ausgelöst.
Wenn der Vorgang erfolgreich abgeschlossen wurde, sollte vor dieser Funktion „ QGeoRouteReply::setRoutes()“ aufgerufen werden. Ist ein Fehler aufgetreten, sollte stattdessen „ QGeoRouteReply::setError()“ verwendet werden.
Siehe auch ` finished()`.
[protected] void QGeoRouteReply::setRoutes(const QList<QGeoRoute> &routes)
Legt die Liste der Routen in der Antwort an routes fest.
Siehe auch 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.
