QPlaceReply Class
Die Klasse QPlaceReply verwaltet eine von einer Instanz von QPlaceManager gestartete Operation und dient als Basisklasse für speziellere 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) |
Detaillierte Beschreibung
Die QPlaceReply und jede ihrer spezialisierten Unterklassen verwalten den Zustand und die Ergebnisse ihrer entsprechenden Operationen. QPlaceReply selbst wird für Operationen verwendet, die keine Ergebnisse haben, d.h. es ist nur notwendig zu wissen, ob die Operation erfolgreich war oder nicht.
Das Signal finished() kann verwendet werden, um den Fortschritt einer Operation zu überwachen. Sobald ein Vorgang abgeschlossen ist, geben die Methoden error() und errorString() Auskunft darüber, ob der Vorgang erfolgreich abgeschlossen wurde. Wenn die Operation erfolgreich war, enthält die Antwort die Ergebnisse für diese Operation, d.h. jede Unterklasse verfügt über geeignete Funktionen, um die Ergebnisse einer Operation abzurufen.
Siehe auch QPlaceManager.
Dokumentation der 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 eine Importdatei hatte ein unleserliches Format |
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 generische Antwort. |
QPlaceReply::DetailsReply | 1 | Es handelt sich um eine Antwort für den Abruf von Ortsangaben |
QPlaceReply::SearchReply | 2 | Dies ist eine Antwort für den Vorgang der Ortssuche. |
QPlaceReply::SearchSuggestionReply | 3 | Dies ist eine Antwort für eine Suchvorschlagsoperation. |
QPlaceReply::ContentReply | 4 | Dies ist eine Antwort für Inhalte, die mit einem Ort verbunden sind. |
QPlaceReply::IdReply | 5 | Dies ist eine Antwort, die einen Bezeichner für einen Ort oder eine Kategorie zurückgibt. Wird in der Regel für das Speichern und Entfernen 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)
Konstruiert ein Antwortobjekt mit einer gegebenen parent.
[virtual noexcept] QPlaceReply::~QPlaceReply()
Zerstört 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 ausgegeben, wenn für diese Antwort aktualisierte Inhalte verfügbar sind. Je nach Plugin kann dieses Signal nie oder mehrmals vor QPlaceReply::finished() ausgegeben werden, da einige Backends in der Lage sind, den angeforderten Inhalt asynchron und inkrementell zurückzugeben.
Hinweis: Löschen Sie dieses Antwortobjekt in dem mit diesem Signal verbundenen Slot nicht oder löschen Sie es später. Tun Sie dies nur auf 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. Wahrscheinlich wird das Signal finished() folgen.
Der Fehler wird durch den Fehlercode error beschrieben. Wenn errorString nicht leer ist, enthält es eine textliche Beschreibung des Fehlers, die für Entwickler und nicht für Endbenutzer bestimmt ist.
Dieses Signal und QPlaceManager::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 QPlaceReply::errorString() const
Gibt die Fehlerzeichenfolge der Antwort zurück. Der Fehlerstring ist nur für Entwickler gedacht und kann nicht für den Endbenutzer angezeigt werden.
Wenn kein Fehler aufgetreten ist, ist die Zeichenkette 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 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 QPlaceReply::isFinished() const
Gibt true zurück, wenn die Antwort abgeschlossen ist.
[protected] void QPlaceReply::setError(QPlaceReply::Error error, const QString &errorString)
Setzt die error und errorString der Antwort. Diese Funktion bewirkt nicht, dass das Signal QPlaceReply::errorOccurred(QPlaceReply::Error, const QString &errorString) ausgegeben wird.
Siehe auch error().
[protected] void QPlaceReply::setFinished(bool finished)
Setzt den Status, ob die Antwort finished ist oder nicht. Diese Funktion bewirkt nicht, dass das Signal finished() ausgegeben wird.
Siehe auch finished().
[virtual] QPlaceReply::Type QPlaceReply::type() const
Gibt den Typ der Antwort zurück.
© 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.
