QPlaceManagerEngine Class

Die Klasse QPlaceManagerEngine bietet eine Schnittstelle für Implementierer von QGeoServiceProvider Plugins, die Zugriff auf die Place-Funktionalität bieten wollen. Mehr...

Header: #include <QPlaceManagerEngine>
qmake: QT += location
Inherits: QObject

Öffentliche Funktionen

QPlaceManagerEngine(const QVariantMap &parameters, 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

Detaillierte Beschreibung

Hinweis: Es gibt keine Garantien für die Quell- oder Binärkompatibilität der Backend-Klassen. Die API funktioniert garantiert nur mit der Qt-Version, für die sie entwickelt wurde. API-Änderungen werden jedoch nur in kleineren Versionen vorgenommen. (6.6, 6.7, und so weiter.)

Anwendungsentwickler müssen sich nicht mit der QPlaceManagerEngine befassen. Backend-Implementierer müssen jedoch von QPlaceManagerEngine ableiten und Implementierungen für die abstrakten virtuellen Funktionen bereitstellen.

Für weitere Informationen zum Schreiben eines Backends siehe die Places Backend Dokumentation.

Siehe auch QPlaceManager.

Dokumentation der Mitgliedsfunktionen

[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

Konstruiert einen neuen Motor mit dem angegebenen parent und verwendet parameters, um alle implementierungsspezifischen Daten an den Motor zu übergeben.

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

Zerstört diesen Motor.

[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const

Gibt die Kategorie zurück, die der angegebenen categoryId entspricht.

[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)

Dieses Signal wird ausgegeben, wenn ein category zum Datenspeicher der Manager-Engine hinzugefügt worden ist. Das Elternteil des category wird durch parentId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)

Dieses Signal wird ausgegeben, wenn die Kategorie, die categoryId entspricht, aus dem Datenspeicher der Manager-Engine entfernt worden ist. Das Elternteil der entfernten Kategorie wird durch parentId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)

Dieses Signal wird ausgegeben, wenn eine category im Datenspeicher der Manager-Engine geändert wurde. Das Elternteil der geänderten Kategorie wird durch parentId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

Gibt eine Liste der Kategorien zurück, die Kinder der Kategorie sind, die parentId entspricht. Ist parentId leer, werden alle Kategorien der obersten Ebene zurückgegeben.

[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

Gibt die Bezeichner der untergeordneten Kategorien der Kategorie zurück, die categoryId entspricht. Wenn categoryId leer ist, werden alle Bezeichner der übergeordneten Kategorien zurückgegeben.

[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

Gibt eine beschnittene oder geänderte Version des Ortes original zurück, die sich zum Speichern durch die Manager-Engine eignet.

In der geänderten Version sind nur Ortsangaben enthalten, die von diesem Manager unterstützt werden. Managerspezifische Daten, wie z. B. die Ortskennung, werden nicht von original übernommen.

[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

Konstruiert eine Icon-Url aus einer gegebenen icon, size. Zurückgegeben wird die URL des Icon-Bildes, das den angegebenen Parametern am ehesten entspricht.

[signal] void QPlaceManagerEngine::dataChanged()

*

Dieses Signal wird von der Engine ausgegeben, wenn es umfangreiche Änderungen an ihrem zugrunde liegenden Datenspeicher gibt und die Engine diese Änderungen als so radikal ansieht, dass die Clients alle Daten neu laden müssen.

Wenn das Signal ausgegeben wird, werden keine anderen Signale für die damit verbundenen Änderungen ausgegeben.

[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 aufgetreten ist. Wahrscheinlich wird das Signal QPlaceManager::finished() folgen.

Der Fehler wird durch den Fehlercode error beschrieben. Wenn errorString nicht leer ist, enthält es eine textuelle Beschreibung des Fehlers, die für Entwickler und nicht für Endbenutzer bestimmt ist.

Dieses Signal und QPlaceReply::errorOccurred() werden zur gleichen Zeit ausgegeben.

Hinweis: Löschen Sie nicht das Objekt reply in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().

[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)

Dieses Signal wird ausgegeben, wenn reply die Verarbeitung abgeschlossen hat.

Wenn reply->error() gleich QPlaceReply::NoError ist, wurde die Verarbeitung erfolgreich abgeschlossen.

Dieses Signal und QPlaceReply::finished() werden zur gleichen Zeit ausgegeben.

Hinweis: Löschen Sie nicht das Objekt reply in dem mit diesem Signal verbundenen Slot. Verwenden Sie stattdessen deleteLater().

[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)

Ruft Inhalte für einen Ort gemäß den in request angegebenen Parametern ab.

[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)

Ruft die Details des Ortes ab, der dem angegebenen placeId entspricht.

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

Initialisiert die Kategorien der Manager-Engine.

[virtual] QList<QLocale> QPlaceManagerEngine::locales() const

Gibt eine Liste der bevorzugten Gebietsschemata zurück. Die Gebietsschemata dienen der Manager-Engine als Hinweis darauf, in welcher Sprache Orts- und Kategoriedetails zurückgegeben werden sollen.

Kann das erste angegebene Gebietsschema nicht berücksichtigt werden, greift die Manager-Engine auf das nächste zurück und so weiter.

Die Unterstützung für Gebietsschemata kann von Anbieter zu Anbieter variieren. Bei den Anbietern, die sie unterstützen, wird standardmäßig global default locale verwendet. Wenn der Manager-Engine keine Gebietsschemata zugewiesen sind, verwendet sie implizit das globale Standardgebietsschema. Für Engines, die keine Gebietsschemata unterstützen, ist die Gebietsschema-Liste immer leer.

Siehe auch setLocales().

[protected] QPlaceManager *QPlaceManagerEngine::manager() const

Gibt die Managerinstanz zurück, die zur Erstellung 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 Managername wird automatisch so gesetzt, dass er mit dem QGeoServiceProviderFactory::providerName() übereinstimmt.

int QPlaceManagerEngine::managerVersion() const

Gibt die Version dieser Engine-Implementierung zurück.

Die Managerversion 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 in request angegebenen Orten entsprechen/übereinstimmen.

[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

Gibt die Kennung der übergeordneten Kategorie zurück, die der Kategorie categoryId entspricht.

[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)

Dieses Signal wird ausgegeben, wenn dem Datenspeicher der Manager-Engine ein Ort hinzugefügt wurde. Der bestimmte hinzugefügte Ort wird durch placeId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)

Dieses Signal wird ausgegeben, wenn ein Ort aus dem Datenspeicher der Manager-Engine entfernt wurde. Der bestimmte Ort, der entfernt wurde, wird durch placeId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das QPlaceManager::NotificationsFeature unterstützen.

Siehe auch dataChanged().

[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)

Dieses Signal wird ausgegeben, wenn eine Stelle im Datenspeicher der Manager-Engine geändert wurde. Der bestimmte geänderte Ort wird durch placeId angegeben.

Dieses Signal wird nur von Manager-Engines ausgegeben, die das 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 Ort, der placeId entspricht, aus dem Datenspeicher der Manager-Engine.

[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)

Speichert eine category, die eine Unterkategorie der durch parentId angegebenen Kategorie ist. Ein leeres parentId bedeutet, dass category als übergeordnete Kategorie gespeichert wird.

[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)

Speichert eine angegebene place im Datenspeicher der Manager-Engine.

Sucht nach Orten gemäß den in request angegebenen Parametern.

[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)

Fordert eine Reihe von Vorschlägen für Suchbegriffe an, die den in request angegebenen Parametern entsprechen.

[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)

Legen Sie die Liste der bevorzugten locales fest.

Siehe auch locales().

© 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.