QPlaceIcon Class
La classe QPlaceIcon représente une icône. En savoir plus…
| Header: | #include <QPlaceIcon> |
| qmake: | QT += location |
Propriétés
- manager : QPlaceManager*
- parameters : QVariantMap
Fonctions publiques
| QPlaceIcon() | |
| QPlaceIcon(const QPlaceIcon &other) | |
| QPlaceIcon(QPlaceIcon &&other) | |
| ~QPlaceIcon() | |
| bool | isEmpty() const |
| QPlaceManager * | manager() const |
| QVariantMap | parameters() const |
| void | setManager(QPlaceManager *manager) |
| void | setParameters(const QVariantMap ¶meters) |
| QUrl | url(const QSize &size = QSize()) const |
| QPlaceIcon & | operator=(const QPlaceIcon &other) |
Membres publics statiques
| const QString | SingleUrl |
Éléments non membres associés
| bool | operator!=(const QPlaceIcon &lhs, const QPlaceIcon &rhs) |
| bool | operator==(const QPlaceIcon &lhs, const QPlaceIcon &rhs) |
Description détaillée
En règle générale, pour utiliser une icône, on fait appel à la fonction url() afin de spécifier la taille souhaitée.
QUrl iconSourceUrl = place.icon().url(QSize(32,32));
//A default icon may also be requested like so
iconSourceUrl = place.icon().url();Les icônes dépendent généralement du backend : si un backend de gestion ne prend pas en charge une taille donnée, l’URL de l’icône qui correspond le mieux à ces paramètres est renvoyée.
La classe « icon » dispose également d’un ensemble de paramètres de type clé-valeur. La clé précise à utiliser dépend du plugin utilisé. Ces paramètres influencent l’URL de l’icône renvoyée par le gestionnaire et peuvent également servir à spécifier l’emplacement des URL d’icônes lors de leur enregistrement.
S’il n’existe qu’une seule image pour une icône, on peut utiliser « QPlaceIcon::SingleUrl » comme clé de paramètre avec « QUrl » comme valeur associée. Si cette clé est définie, la fonction url() renverra toujours l’URL spécifiée sans s’en remettre à un gestionnaire.
Documentation sur les propriétés
manager : QPlaceManager*
Cette propriété contient le gestionnaire de cette icône.
Fonctions d'accès :
| QPlaceManager * | manager() const |
| void | setManager(QPlaceManager *manager) |
parameters : QVariantMap
Cette propriété contient l'ensemble des paramètres de l'icône spécifiques au gestionnaire ou au plugin.
Fonctions d'accès :
| QVariantMap | parameters() const |
| void | setParameters(const QVariantMap ¶meters) |
Documentation sur les fonctions membres
QPlaceIcon::QPlaceIcon()
Crée une icône.
[noexcept] QPlaceIcon::QPlaceIcon(const QPlaceIcon &other)
Crée une copie de other.
[constexpr noexcept default] QPlaceIcon::QPlaceIcon(QPlaceIcon &&other)
Crée une instance de ` QPlaceIcon` à l'aide de la construction « move ».
[noexcept] QPlaceIcon::~QPlaceIcon()
Supprime l'icône.
bool QPlaceIcon::isEmpty() const
Renvoie une valeur booléenne indiquant si tous les champs de l'icône sont vides ou non.
QPlaceManager *QPlaceIcon::manager() const
Renvoie le gestionnaire auquel cette icône est associée.
Remarque : fonctiongetter pour la propriété manager.
Voir aussi setManager().
QVariantMap QPlaceIcon::parameters() const
Renvoie un ensemble de paramètres spécifiques au gestionnaire/plugin pour l’icône. Ces paramètres sont utilisés par le gestionnaire pour renvoyer l’URL appropriée lorsque la fonction url() est appelée, ainsi que pour spécifier les emplacements d’enregistrement lors de la sauvegarde des icônes.
Consultez la documentation du plugin pour connaître les paramètres pris en charge et leur mode d'utilisation.
Remarque : fonctiongetter pour les paramètres de propriété.
Voir également setParameters().
void QPlaceIcon::setManager(QPlaceManager *manager)
Définit l'manager e à laquelle cette icône est associée. L'icône ne prend pas possession du pointeur.
Remarque : fonctionde définition de la propriété manager.
Voir aussi manager().
void QPlaceIcon::setParameters(const QVariantMap ¶meters)
Définit les paramètres de l'icône sur parameters.
Remarque : fonctionde définition de la propriété parameters.
Voir aussi parameters().
[invokable] QUrl QPlaceIcon::url(const QSize &size = QSize()) const
Renvoie l'URL d'une icône en fonction de l'size fournie.
Si aucun gestionnaire n'a été attribué à l'icône et que les paramètres ne contiennent pas la clé QPlaceIcon::SingleUrl, un objet QUrl construit par défaut est renvoyé.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[noexcept] QPlaceIcon &QPlaceIcon::operator=(const QPlaceIcon &other)
Attribue la propriété « other » à cette icône et renvoie une référence à celle-ci.
Documentation sur les variables membres
const QString QPlaceIcon::SingleUrl
Clé de paramètre pour une icône ne comportant qu'une seule URL d'image.
La valeur de paramètre à utiliser avec cette clé est une URL QUrl. Une icône pour laquelle ce paramètre est défini renverra toujours l'URL spécifiée, quelle que soit la taille demandée, lorsque la fonction url() est appelée.
Éléments connexes (non membres)
[noexcept] bool operator!=(const QPlaceIcon &lhs, const QPlaceIcon &rhs)
Renvoie « true » si lhs n'est pas égal à rhs; sinon, renvoie « false ».
[noexcept] bool operator==(const QPlaceIcon &lhs, const QPlaceIcon &rhs)
Renvoie « true » si « lhs » est égal à « rhs », sinon renvoie « false ».
© 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.
