QGeoCodeReply Class
Die Klasse QGeoCodeReply verwaltet einen Vorgang, der von einer Instanz von QGeoCodingManager gestartet wurde. Mehr...
| Header: | #include <QGeoCodeReply> |
| qmake: | QT += location |
| Inherits: | QObject |
Öffentliche Typen
| enum | Error { NoError, EngineNotSetError, CommunicationError, ParseError, UnsupportedOptionError, …, UnknownError } |
Öffentliche Funktionen
| QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr) | |
| virtual | ~QGeoCodeReply() |
| virtual void | abort() |
| QGeoCodeReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| qsizetype | limit() const |
| QList<QGeoLocation> | locations() const |
| qsizetype | offset() const |
| QGeoShape | viewport() const |
Signale
| void | aborted() |
| void | errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Geschützte Funktionen
| QGeoCodeReply(QObject *parent = nullptr) | |
| void | addLocation(const QGeoLocation &location) |
| void | setError(QGeoCodeReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
| void | setLimit(qsizetype limit) |
| void | setLocations(const QList<QGeoLocation> &locations) |
| void | setOffset(qsizetype offset) |
| void | setViewport(const QGeoShape &viewport) |
Detaillierte Beschreibung
Instanzen von QGeoCodeReply verwalten den Zustand und die Ergebnisse dieser Operationen.
Die Methoden isFinished(), error() und errorString() liefern Informationen darüber, ob der Vorgang abgeschlossen wurde und ob er erfolgreich war.
Die Signale finished() und errorOccurred(QGeoCodeReply::Error,QString) können verwendet werden, um den Fortschritt des Vorgangs zu überwachen.
Es ist möglich, dass sich ein neu erstelltes QGeoCodeReply in einem beendeten Zustand befindet, meist weil ein Fehler aufgetreten ist. Da eine solche Instanz niemals die Signale finished() oder errorOccurred(QGeoCodeReply::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 QGeoCodingManager zeigt, wie dies durchgeführt werden kann.
Wenn die Operation erfolgreich abgeschlossen wurde, können die Ergebnisse mit locations() abgerufen werden.
Dokumentation der Mitgliedstypen
enum QGeoCodeReply::Error
Beschreibt einen Fehler, der den Abschluss des Vorgangs verhindert hat.
| Konstante | Wert | Beschreibung |
|---|---|---|
QGeoCodeReply::NoError | 0 | Es ist kein Fehler aufgetreten. |
QGeoCodeReply::EngineNotSetError | 1 | Dem verwendeten Geokodierungsmanager war keine QGeoCodingManagerEngine -Instanz zugeordnet. |
QGeoCodeReply::CommunicationError | 2 | Bei der Kommunikation mit dem Dienstanbieter ist ein Fehler aufgetreten. |
QGeoCodeReply::ParseError | 3 | Die Antwort des Dienstanbieters lag in einem nicht erkennbaren Format vor. |
QGeoCodeReply::UnsupportedOptionError | 4 | Der angeforderte Vorgang oder eine der Optionen für den Vorgang wird vom Dienstanbieter nicht unterstützt. |
QGeoCodeReply::CombinationError | 5 | Bei der Kombination von Ergebnissen aus mehreren Quellen ist ein Fehler aufgetreten. |
QGeoCodeReply::UnknownError | 6 | Es ist ein Fehler aufgetreten, der in keine der anderen Kategorien passt. |
Dokumentation der Mitgliedsfunktionen
[explicit protected] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)
Konstruiert eine Geocode-Antwort mit dem angegebenen parent.
[explicit] QGeoCodeReply::QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)
Konstruiert eine Geocode-Antwort mit einem gegebenen error und errorString und dem angegebenen parent.
[virtual noexcept] QGeoCodeReply::~QGeoCodeReply()
Zerstört dieses Antwortobjekt.
[virtual] void QGeoCodeReply::abort()
Bricht den Vorgang sofort ab.
Dies bewirkt nichts, wenn die Antwort beendet ist.
Siehe auch aborted().
[signal] void QGeoCodeReply::aborted()
Dieses Signal wird ausgegeben, wenn der Vorgang abgebrochen wurde.
Siehe auch abort().
[protected] void QGeoCodeReply::addLocation(const QGeoLocation &location)
Fügt location zur Liste der Orte in dieser Antwort hinzu.
QGeoCodeReply::Error QGeoCodeReply::error() const
Gibt den Fehlerstatus dieser Antwort zurück.
Wenn das Ergebnis QGeoCodeReply::NoError ist, ist kein Fehler aufgetreten.
Siehe auch setError().
[signal] void QGeoCodeReply::errorOccurred(QGeoCodeReply::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 QGeoCodingManager::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 QGeoCodeReply::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 QGeoCodeReply::error() gleich QGeoCodeReply::NoError ist.
[signal] void QGeoCodeReply::finished()
Dieses Signal wird ausgegeben, wenn die Verarbeitung dieser Antwort abgeschlossen ist.
Wenn error() gleich QGeoCodeReply::NoError ist, wurde die Verarbeitung erfolgreich abgeschlossen.
Dieses Signal und QGeoCodingManager::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 QGeoCodeReply::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.
qsizetype QGeoCodeReply::limit() const
Gibt das Limit für die Anzahl der Antworten aus jeder Datenquelle zurück.
Wurde keine Begrenzung festgelegt, gibt diese Funktion -1 zurück.
Dies kann mehr als locations().length() sein, wenn die Anzahl der Antworten geringer als die angeforderte Anzahl war.
Siehe auch setLimit().
QList<QGeoLocation> QGeoCodeReply::locations() const
Gibt eine Liste von Orten zurück.
Die Orte sind die Ergebnisse der Operation, die der Funktion QGeoCodingManager entspricht, die diese Antwort erstellt hat.
Siehe auch setLocations().
qsizetype QGeoCodeReply::offset() const
Gibt den Offset in der gesamten Ergebnismenge zurück, an dem der Abruf der Ergebnisse beginnen soll.
Siehe auch setOffset().
[protected] void QGeoCodeReply::setError(QGeoCodeReply::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 QGeoCodeReply::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 QGeoCodeReply::setLocations() vor dieser Funktion aufgerufen werden. Ist ein Fehler aufgetreten, sollte stattdessen QGeoCodeReply::setError() verwendet werden.
Siehe auch finished().
[protected] void QGeoCodeReply::setLimit(qsizetype limit)
Legt den Grenzwert für die Anzahl der Antworten aus jeder Datenquelle auf limit fest.
Wenn limit -1 ist, werden alle verfügbaren Antworten zurückgegeben.
Siehe auch limit().
[protected] void QGeoCodeReply::setLocations(const QList<QGeoLocation> &locations)
Legt die Liste von locations in der Antwort fest.
Siehe auch locations().
[protected] void QGeoCodeReply::setOffset(qsizetype offset)
Legt den Offset in der gesamten Ergebnismenge fest, an dem der Abruf des Ergebnisses auf offset beginnen soll.
Siehe auch offset().
[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)
Setzt das Ansichtsfenster, das die Ergebnisse enthält, auf viewport.
Siehe auch viewport().
QGeoShape QGeoCodeReply::viewport() const
Gibt das Ansichtsfenster zurück, das die Ergebnisse enthält.
Diese Funktion gibt nullptr zurück, wenn in der Funktion QGeoCodingManager, mit der diese Antwort erstellt wurde, kein Viewport-Bias angegeben wurde.
Siehe auch setViewport().
© 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.
