QPlaceManagerEngine Class
La classe `QPlaceManagerEngine` fournit une interface aux développeurs de plugins « QGeoServiceProvider » qui souhaitent offrir un accès aux fonctionnalités de placement. En savoir plus...
| Header: | #include <QPlaceManagerEngine> |
| qmake: | QT += location |
| Inherits: | QObject |
Fonctions publiques
| 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) |
Signaux
| 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) |
Fonctions protégées
| QPlaceManager * | manager() const |
Description détaillée
Remarque : aucune compatibilité source ou binairen'est garantie pour les classes du backend. Le fonctionnement de l'API n'est garanti qu'avec la version de Qt pour laquelle elle a été développée. Les modifications de l'API ne seront toutefois apportées que dans les versions mineures (6.6, 6.7, etc.).
Les développeurs d'applications n'ont pas à se soucier de QPlaceManagerEngine. Les développeurs de backends devront toutefois dériver de QPlaceManagerEngine et fournir des implémentations pour les fonctions virtuelles abstraites.
Pour plus d’informations sur l’écriture d’un backend, consultez la documentation du backend Places.
Voir également QPlaceManager.
Documentation sur les fonctions membres
[explicit] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap ¶meters, QObject *parent = nullptr)
Crée un nouveau moteur avec l'parent spécifiée, en utilisant parameters pour transmettre au moteur toutes les données spécifiques à l'implémentation.
[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()
Cela détruit ce moteur.
[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const
Renvoie la catégorie correspondant à l'categoryId on fournie.
[signal] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)
Ce signal est émis lorsqu’un « category » a été ajouté au magasin de données du moteur de gestion. Le parent de l’« category » est spécifié par « parentId ».
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[signal] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)
Ce signal est émis lorsque la catégorie correspondant à categoryId a été supprimée du magasin de données du moteur de gestion. Le parent de la catégorie supprimée est spécifié par parentId.
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[signal] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)
Ce signal est émis lorsqu'une catégorie ( category ) a été modifiée dans le magasin de données du moteur de gestion. La catégorie parente de la catégorie modifiée est spécifiée par parentId.
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const
Renvoie une liste des catégories qui sont des sous-catégories de la catégorie correspondant à parentId. Si parentId est vide, toutes les catégories de premier niveau sont renvoyées.
[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const
Renvoie les identifiants des sous-catégories de la catégorie correspondant à categoryId. Si categoryId est vide, tous les identifiants des catégories de premier niveau sont renvoyés.
[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const
Renvoie une version allégée ou modifiée de l'objet « place » issu de original, adaptée à l'enregistrement par le moteur de gestion.
Seules les informations sur le lieu prises en charge par ce gestionnaire sont présentes dans la version modifiée. Les données spécifiques au gestionnaire, telles que l'identifiant du lieu, ne sont pas copiées depuis original.
[virtual] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)
Construit une URL d'icône à partir des paramètres icon et size fournis. L'URL de l'image d'icône qui correspond le mieux aux paramètres fournis est renvoyée.
[signal] void QPlaceManagerEngine::dataChanged()
*
Ce signal est émis par le moteur en cas de modifications importantes apportées à son magasin de données sous-jacent, lorsque le moteur estime que ces modifications sont suffisamment radicales pour nécessiter le rechargement de toutes les données par les clients.
Si ce signal est émis, aucun autre signal ne sera émis pour les modifications associées.
[signal] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
Ce signal est émis lorsqu'une erreur a été détectée lors du traitement de reply. Le signal QPlaceManager::finished() suivra probablement.
L'erreur sera décrite par le code d'erreur error. Si errorString n'est pas vide, il contiendra une description textuelle de l'erreur destinée aux développeurs et non aux utilisateurs finaux.
Ce signal et QPlaceReply::errorOccurred() seront émis simultanément.
Remarque : ne supprimezpas l’objet ` reply ` dans le slot connecté à ce signal. Utilisez plutôt la fonction ` deleteLater()`.
[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)
Ce signal est émis lorsque le traitement de ` reply ` est terminé.
Si reply->error() est égal à QPlaceReply::NoError, cela signifie que le traitement s'est terminé avec succès.
Ce signal et la fonction QPlaceReply::finished() seront émis simultanément.
Remarque : ne supprimezpas l’objet ` reply ` dans le slot connecté à ce signal. Utilisez plutôt ` deleteLater()`.
[virtual] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)
Récupère le contenu associé à un lieu en fonction des paramètres spécifiés dans request.
[virtual] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)
Récupère les informations relatives au lieu correspondant à l'placeId.
[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()
Initialise les catégories du moteur de gestion.
[virtual] QList<QLocale> QPlaceManagerEngine::locales() const
Renvoie une liste de paramètres régionaux préférés. Ces paramètres régionaux servent d'indication au moteur de gestion pour déterminer la langue dans laquelle les détails relatifs au lieu et à la catégorie doivent être renvoyés.
Si la première locale spécifiée ne peut pas être prise en charge, le moteur de gestion passe à la suivante, et ainsi de suite.
La prise en charge des paramètres régionaux peut varier d’un fournisseur à l’autre. Pour ceux qui les prennent en charge, la valeur par défaut global default locale sera utilisée. Si aucun paramètre régional n’est attribué au moteur de gestion, celui-ci utilise implicitement le paramètre régional global par défaut. Pour les moteurs qui ne prennent pas en charge les paramètres régionaux, la liste des paramètres régionaux est toujours vide.
Voir également setLocales().
[protected] QPlaceManager *QPlaceManagerEngine::manager() const
Renvoie l'instance du gestionnaire utilisée pour créer ce moteur.
QString QPlaceManagerEngine::managerName() const
Renvoie le nom utilisé par cette implémentation du moteur pour se distinguer des implémentations fournies par d'autres plugins.
Le nom du gestionnaire est automatiquement défini pour correspondre à la valeur de QGeoServiceProviderFactory::providerName().
int QPlaceManagerEngine::managerVersion() const
Renvoie la version de cette implémentation du moteur.
La version du gestionnaire est automatiquement définie pour correspondre à celle de QGeoServiceProviderFactory::providerVersion().
[virtual] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)
Renvoie une réponse contenant une liste des lieux qui correspondent à ceux spécifiés à l'adresse request.
[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const
Renvoie l'identifiant de la catégorie parente de la catégorie correspondant à categoryId.
[signal] void QPlaceManagerEngine::placeAdded(const QString &placeId)
Ce signal est émis lorsqu'un lieu a été ajouté au magasin de données du moteur de gestion. Le lieu ajouté est identifié par l'placeId.
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[signal] void QPlaceManagerEngine::placeRemoved(const QString &placeId)
Ce signal est émis lorsqu'un lieu a été supprimé du magasin de données du moteur de gestion. Le lieu concerné est spécifié par placeId.
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[signal] void QPlaceManagerEngine::placeUpdated(const QString &placeId)
Ce signal est émis lorsqu'un lieu a été modifié dans le magasin de données du moteur de gestion. Le lieu concerné par la modification est spécifié par ` placeId`.
Ce signal n'est émis que par les moteurs de gestion prenant en charge la fonctionnalité QPlaceManager::NotificationsFeature.
Voir également dataChanged().
[virtual] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)
Supprime la catégorie correspondant à categoryId de la base de données du moteur de gestion.
[virtual] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)
Supprime l'entrée correspondant à placeId de la base de données du moteur de gestion.
[virtual] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)
Enregistre une « category » qui est une sous-catégorie de la catégorie spécifiée par « parentId ». Une valeur vide pour « parentId » signifie que « category » est enregistrée en tant que catégorie de premier niveau.
[virtual] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)
Enregistre une « place » spécifiée dans le magasin de données du moteur de gestion.
[virtual] QPlaceSearchReply *QPlaceManagerEngine::search(const QPlaceSearchRequest &request)
Recherche de lieux selon les paramètres indiqués sur request.
[virtual] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)
Demande une liste de suggestions de termes de recherche en fonction des paramètres indiqués sur request.
[virtual] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)
Définissez la liste des sites préférés : locales.
Voir aussi 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.