QPlaceReply Class
Die Klasse „QPlaceReply“ verwaltet einen Vorgang, der von einer Instanz von „ QPlaceManager “ gestartet wurde, und dient als Basisklasse für spezialisiertere Antworten. Mehr...
| Header: | #include <QPlaceReply> |
| qmake: | QT += location |
| Inherits: | QObject |
| Inherited By: | QPlaceContentReply, QPlaceDetailsReply, QPlaceIdReply, QPlaceMatchReply, QPlaceSearchReply, and QPlaceSearchSuggestionReply |
Öffentliche Typen
| enum | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| enum | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
Öffentliche Funktionen
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
Öffentliche Slots
| virtual void | abort() |
Signale
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
Geschützte Funktionen
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
Ausführliche Beschreibung
QPlaceReply und jede seiner spezialisierten Unterklassen verwalten den Status und die Ergebnisse der jeweiligen Operationen. QPlaceReply selbst wird für Operationen verwendet, die keine Ergebnisse liefern, d. h., es muss lediglich festgestellt werden, ob die Operation erfolgreich war oder fehlgeschlagen ist.
Das Signal „ finished()“ kann verwendet werden, um den Fortschritt einer Operation zu überwachen. Sobald eine Operation abgeschlossen ist, liefern die Methoden „ error()“ und „ errorString()“ Informationen darüber, ob die Operation erfolgreich abgeschlossen wurde. Im Erfolgsfall enthält die Antwort die Ergebnisse dieser Operation, d. h., jede Unterklasse verfügt über entsprechende Funktionen zum Abrufen der Ergebnisse einer Operation.
Siehe auch QPlaceManager.
Dokumentation zu Mitgliedstypen
enum QPlaceReply::Error
Beschreibt einen Fehler, der während eines Vorgangs aufgetreten ist.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPlaceReply::NoError | 0 | Es ist kein Fehler aufgetreten |
QPlaceReply::PlaceDoesNotExistError | 1 | Ein angegebener Ort konnte nicht gefunden werden |
QPlaceReply::CategoryDoesNotExistError | 2 | Eine angegebene Kategorie konnte nicht gefunden werden |
QPlaceReply::CommunicationError | 3 | Bei der Kommunikation mit dem Dienstanbieter ist ein Fehler aufgetreten. |
QPlaceReply::ParseError | 4 | Die Antwort des Dienstanbieters oder einer Importdatei lag in einem nicht erkennbaren Format vor |
QPlaceReply::PermissionsError | 5 | Der Vorgang ist aufgrund unzureichender Berechtigungen fehlgeschlagen. |
QPlaceReply::UnsupportedError | 6 | Der Vorgang wurde vom Dienstanbieter nicht unterstützt. |
QPlaceReply::BadArgumentError | 7 | . Ein übergebener Parameter war ungültig. |
QPlaceReply::CancelError | 8 | Der Vorgang wurde abgebrochen. |
QPlaceReply::UnknownError | 9 | Es ist ein Fehler aufgetreten, der in keine der anderen Kategorien passt. |
enum QPlaceReply::Type
Beschreibt den Typ der Antwort.
| Konstante | Wert | Beschreibung |
|---|---|---|
QPlaceReply::Reply | 0 | Dies ist eine allgemeine Antwort. |
QPlaceReply::DetailsReply | 1 | Dies ist eine Antwort zum Abruf von Ortsdetails |
QPlaceReply::SearchReply | 2 | Dies ist eine Antwort auf die Ortssuche. |
QPlaceReply::SearchSuggestionReply | 3 | Dies ist eine Antwort auf eine Suchvorschlagsanfrage. |
QPlaceReply::ContentReply | 4 | Dies ist eine Antwort auf eine Abfrage nach Inhalten, die mit einem Ort verknüpft sind. |
QPlaceReply::IdReply | 5 | Dies ist eine Antwort, die eine Kennung eines Ortes oder einer Kategorie zurückgibt. Wird in der Regel für Vorgänge zum Speichern und Löschen von Orten oder Kategorien verwendet. |
QPlaceReply::MatchReply | 6 | Dies ist eine Antwort, die Orte zurückgibt, die mit denen eines anderen Anbieters übereinstimmen. |
Dokumentation der Mitgliedsfunktionen
[explicit] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
Erstellt ein Antwortobjekt mit einem angegebenen ` parent`.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Löscht das Antwortobjekt.
[virtual slot] void QPlaceReply::abort()
Bricht den Vorgang sofort ab.
Siehe auch aborted().
[signal] void QPlaceReply::aborted()
Dieses Signal wird ausgegeben, wenn der Vorgang abgebrochen wurde.
Siehe auch „ abort()“.
[signal] void QPlaceReply::contentUpdated()
Dieses Signal wird ausgelöst, wenn für diese Antwort aktualisierte Inhalte verfügbar sind. Je nach Plugin wird dieses Signal möglicherweise gar nicht oder mehrmals ausgelöst, bevor „ QPlaceReply::finished()“ ausgelöst wird, da einige Backends in der Lage sind, die angeforderten Inhalte asynchron und schrittweise zurückzugeben.
Hinweis: Löschen Sie dieses Antwortobjekt nicht mit `delete` oder `deleteLater` in dem mit diesem Signal verbundenen Slot. Tun Sie dies erst bei ` QPlaceReply::finished`.
QPlaceReply::Error QPlaceReply::error() const
Gibt den Fehlercode zurück.
Siehe auch setError().
[signal] void QPlaceReply::errorOccurred(QPlaceReply::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 folgen.
Der Fehler wird durch den Fehlercode ` error` beschrieben. Ist ` errorString ` nicht leer, enthält es eine textuelle Beschreibung des Fehlers, die sich an Entwickler und nicht an Endbenutzer richtet.
Dieses Signal und „ QPlaceManager::errorOccurred()“ werden gleichzeitig ausgelöst.
Hinweis: LöschenSie dieses Antwortobjekt nicht im mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen ` deleteLater()`.
QString QPlaceReply::errorString() const
Gibt die Fehlermeldung der Antwort zurück. Die Fehlermeldung ist ausschließlich für Entwickler bestimmt und nicht für die Anzeige beim Endbenutzer geeignet.
Wenn kein Fehler aufgetreten ist, ist die Zeichenfolge leer.
[signal] void QPlaceReply::finished()
Dieses Signal wird ausgegeben, wenn die Verarbeitung dieser Antwort abgeschlossen ist.
Wenn ` error()` gleich ` QPlaceReply::NoError ` ist, wurde die Verarbeitung erfolgreich abgeschlossen.
Dieses Signal und QPlaceManager::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 QPlaceReply::isFinished() const
Gibt „true“ zurück, wenn die Antwort abgeschlossen ist.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
Legt die Werte für „ error “ und „ errorString “ der Antwort fest. Diese Funktion löst kein Signal vom Typ „ QPlaceReply::errorOccurred “ (QPlaceReply::Error, const QString &errorString) aus.
Siehe auch error().
[protected] void QPlaceReply::setFinished(bool finished)
Legt fest, ob die Antwort „ finished “ lautet oder nicht. Diese Funktion löst kein „ finished()“-Signal aus.
Siehe auch ` finished()`.
[virtual] QPlaceReply::Type QPlaceReply::type() const
Gibt den Typ der Antwort zurück.
© 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.
