QPlaceManagerEngine Class
Die Klasse „QPlaceManagerEngine“ bietet eine Schnittstelle für Entwickler von „ QGeoServiceProvider “-Plugins, die Zugriff auf Platzierungsfunktionen bereitstellen möchten. Mehr...
| Header: | #include <QPlaceManagerEngine> |
| qmake: | QT += location |
| Inherits: | QObject |
Öffentliche Funktionen
| QPlaceManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr) | |
| virtual | ~QPlaceManagerEngine() |
| virtual QPlaceCategory | category(const QString &categoryId) const |
| virtual QList<QPlaceCategory> | childCategories(const QString &parentId) const |
| virtual QStringList | childCategoryIds(const QString &categoryId) const |
| virtual QPlace | compatiblePlace(const QPlace &original) const |
| virtual QUrl | constructIconUrl(const QPlaceIcon &icon, const QSize &size) const |
| virtual QPlaceContentReply * | getPlaceContent(const QPlaceContentRequest &request) |
| virtual QPlaceDetailsReply * | getPlaceDetails(const QString &placeId) |
| virtual QPlaceReply * | initializeCategories() |
| virtual QList<QLocale> | locales() const |
| QString | managerName() const |
| int | managerVersion() const |
| virtual QPlaceMatchReply * | matchingPlaces(const QPlaceMatchRequest &request) |
| virtual QString | parentCategoryId(const QString &categoryId) const |
| virtual QPlaceIdReply * | removeCategory(const QString &categoryId) |
| virtual QPlaceIdReply * | removePlace(const QString &placeId) |
| virtual QPlaceIdReply * | saveCategory(const QPlaceCategory &category, const QString &parentId) |
| virtual QPlaceIdReply * | savePlace(const QPlace &place) |
| virtual QPlaceSearchReply * | search(const QPlaceSearchRequest &request) |
| virtual QPlaceSearchSuggestionReply * | searchSuggestions(const QPlaceSearchRequest &request) |
| virtual void | setLocales(const QList<QLocale> &locales) |
Signale
| void | categoryAdded(const QPlaceCategory &category, const QString &parentId) |
| void | categoryRemoved(const QString &categoryId, const QString &parentId) |
| void | categoryUpdated(const QPlaceCategory &category, const QString &parentId) |
| void | dataChanged() |
| void | errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished(QPlaceReply *reply) |
| void | placeAdded(const QString &placeId) |
| void | placeRemoved(const QString &placeId) |
| void | placeUpdated(const QString &placeId) |
Geschützte Funktionen
| QPlaceManager * | manager() const |
Ausführliche Beschreibung
Hinweis: Es gibt keine Garantien hinsichtlich der Quell- oder Binärkompatibilität für die Backend-Klassen. Die API funktioniert garantiert nur mit der Qt-Version, für die sie entwickelt wurde. API-Änderungen werden jedoch nur in Minor-Releases vorgenommen (6.6, 6.7 usw.).
Anwendungsentwickler müssen sich nicht mit der `QPlaceManagerEngine` befassen. Backend-Implementierer müssen jedoch von der `QPlaceManagerEngine` ableiten und Implementierungen für die abstrakten virtuellen Funktionen bereitstellen.
Weitere Informationen zum Erstellen eines Backends finden Sie in der Dokumentation zum Places-Backend.
Siehe auch QPlaceManager.
Dokumentation zu den Mitgliedsfunktionen
[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr)
Erstellt eine neue Engine mit dem angegebenen ` parent` und verwendet ` parameters `, um implementierungsspezifische Daten an die Engine zu übergeben.
[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()
Das zerstört diesen Motor.
[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const
Gibt die Kategorie zurück, die dem angegebenen „ categoryId “ entspricht.
[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)
Dieses Signal wird ausgelöst, wenn ein „ category “ zum Datenspeicher der Manager-Engine hinzugefügt wurde. Das übergeordnete Element des „ category “ wird durch „ parentId “ angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch „ dataChanged()“.
[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)
Dieses Signal wird ausgelöst, wenn die Kategorie, die „ categoryId “ entspricht, aus dem Datenspeicher der Manager-Engine entfernt wurde. Die übergeordnete Kategorie der entfernten Kategorie wird durch „ parentId “ angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch dataChanged().
[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)
Dieses Signal wird ausgelöst, wenn eine „ category “ im Datenspeicher der Manager-Engine geändert wurde. Die übergeordnete Kategorie der geänderten Kategorie wird durch „ parentId “ angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch ` dataChanged()`.
[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const
Gibt eine Liste der Unterkategorien der Kategorie zurück, die unter parentId zu finden ist. Ist parentId leer, werden alle Kategorien der obersten Ebene zurückgegeben.
[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const
Gibt die Kennungen der Unterkategorien der Kategorie zurück, die categoryId entspricht. Ist categoryId leer, werden alle Kennungen der obersten Kategorieebene zurückgegeben.
[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const
Gibt eine bereinigte oder modifizierte Version des Ortes „ original “ zurück, die für die Speicherung durch die Manager-Engine geeignet ist.
In der modifizierten Version sind nur die Ortsdetails enthalten, die von diesem Manager unterstützt werden. Managerspezifische Daten wie die Orts-ID werden nicht aus dem „ original “ übernommen.
[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)
Erstellt eine Icon-URL aus den angegebenen Werten für ` icon` und ` size`. Es wird die URL des Icon-Bildes zurückgegeben, die den angegebenen Parametern am ehesten entspricht.
[signal] void QPlaceManagerEngine::dataChanged()
*
Dieses Signal wird von der Engine ausgegeben, wenn umfangreiche Änderungen am zugrunde liegenden Datenspeicher vorgenommen werden und die Engine diese Änderungen als so gravierend erachtet, dass Clients alle Daten neu laden müssen.
Wird dieses Signal ausgesendet, werden für die damit verbundenen Änderungen keine weiteren Signale ausgesendet.
[signal] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
Dieses Signal wird ausgegeben, wenn bei der Verarbeitung von reply ein Fehler festgestellt wurde. Das Signal QPlaceManager::finished() wird wahrscheinlich darauf folgen.
Der Fehler wird durch den Fehlercode ` error` beschrieben. Wenn ` errorString ` nicht leer ist, enthält es eine textuelle Beschreibung des Fehlers, die sich an Entwickler und nicht an Endbenutzer richtet.
Dieses Signal und QPlaceReply::errorOccurred() werden gleichzeitig ausgelöst.
Hinweis: LöschenSie das „ reply “-Objekt nicht im mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen „ deleteLater()“.
[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)
Dieses Signal wird ausgelöst, wenn die Verarbeitung von „ reply “ abgeschlossen ist.
Wenn reply->error() gleich QPlaceReply::NoError ist, wurde die Verarbeitung erfolgreich abgeschlossen.
Dieses Signal und ` QPlaceReply::finished()` werden gleichzeitig ausgelöst.
Hinweis: LöschenSie das „ reply “-Objekt nicht in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen „ deleteLater()“.
[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)
Ruft Inhalte zu einem Ort gemäß den unter request angegebenen Parametern ab.
[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)
Ruft Details zu dem Ort ab, der der angegebenen URL placeId entspricht.
[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()
Initialisiert die Kategorien der Manager-Engine.
[virtual] QList<QLocale> QPlaceManagerEngine::locales() const
Gibt eine Liste der bevorzugten Locales zurück. Die Locales dienen der Manager-Engine als Hinweis darauf, in welcher Sprache und für welche Kategorie Details zurückgegeben werden sollen.
Kann die erste angegebene Locale nicht berücksichtigt werden, greift die Manager-Engine auf die nächste zurück und so weiter.
Die Unterstützung für Locales kann je nach Anbieter variieren. Bei Anbietern, die dies unterstützen, wird standardmäßig die „ global default locale “ verwendet. Wenn der Manager-Engine keine Locales zugewiesen sind, verwendet sie implizit die globale Standard-Locale. Bei Engines, die keine Locales unterstützen, ist die Locale-Liste immer leer.
Siehe auch setLocales().
[protected] QPlaceManager *QPlaceManagerEngine::manager() const
Gibt die Manager-Instanz zurück, die zum Erstellen dieser Engine verwendet wurde.
QString QPlaceManagerEngine::managerName() const
Gibt den Namen zurück, den diese Engine-Implementierung verwendet, um sich von den Implementierungen anderer Plugins zu unterscheiden.
Der Manager-Name wird automatisch so gesetzt, dass er mit dem Wert von `QGeoServiceProviderFactory::providerName()` übereinstimmt.
int QPlaceManagerEngine::managerVersion() const
Gibt die Version dieser Engine-Implementierung zurück.
Die Manager-Version wird automatisch so eingestellt, dass sie mit der `QGeoServiceProviderFactory::providerVersion()` übereinstimmt.
[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)
Gibt eine Antwort zurück, die eine Liste von Orten enthält, die den unter request angegebenen entsprechen.
[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const
Gibt die Kennung der übergeordneten Kategorie der Kategorie zurück, die „ categoryId “ entspricht.
[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)
Dieses Signal wird ausgelöst, wenn ein Ort zum Datenspeicher der Manager-Engine hinzugefügt wurde. Der konkret hinzugefügte Ort wird durch ` placeId` angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch dataChanged().
[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)
Dieses Signal wird ausgelöst, wenn ein Ort aus dem Datenspeicher der Manager-Engine entfernt wurde. Der konkrete Ort, der entfernt wurde, wird durch „ placeId “ angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch ` dataChanged()`.
[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)
Dieses Signal wird ausgelöst, wenn ein Ort im Datenspeicher der Manager-Engine geändert wurde. Der konkret geänderte Ort wird durch ` placeId` angegeben.
Dieses Signal wird nur von Manager-Engines ausgegeben, die die Funktion `QPlaceManager::NotificationsFeature` unterstützen.
Siehe auch ` dataChanged()`.
[virtual] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)
Entfernt die Kategorie, die „ categoryId “ entspricht, aus dem Datenspeicher der Manager-Engine.
[virtual] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)
Entfernt den Eintrag „ placeId “ aus dem Datenspeicher der Manager-Engine.
[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)
Speichert eine „ category “, die eine Unterkategorie der unter parentId angegebenen Kategorie ist. Eine leere parentId bedeutet, dass „ category “ als oberste Kategorie gespeichert wird.
[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)
Speichert ein angegebenes „ place “ im Datenspeicher der Manager-Engine.
[virtual] QPlaceSearchReply *QPlaceManagerEngine::search(const QPlaceSearchRequest &request)
Sucht nach Orten anhand der unter request angegebenen Parameter.
[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)
Fordert eine Reihe von Suchbegriffsvorschlägen entsprechend den unter request angegebenen Parametern an.
[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)
Legen Sie die Liste der bevorzugten locales fest.
Siehe auch locales().
© 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.