MapItemView QML Type
La classe `MapItemView` sert à remplir la carte à partir d'un modèle. En savoir plus...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
| Inherits: |
- Liste de tous les membres, y compris les membres hérités
- MapItemView fait partie du plugin QML Maps.
Propriétés
- add : Transition
(since QtLocation 5.12) - autoFitViewport : bool
- delegate : Component
- delegateModelAccess : enumeration
(since 6.10) - model : model
- remove : Transition
(since QtLocation 5.12)
Description détaillée
La classe MapItemView sert à remplir une carte (Map) avec des éléments de carte (MapItems) provenant d'un modèle. Le type MapItemView n'a de sens que lorsqu'il est contenu dans une carte (Map), ce qui signifie qu'il n'a pas d'affichage autonome.
Exemple d'utilisation
Cet exemple montre comment utiliser l'objet MapViewItem pour afficher un élément « route » sur une carte « map » :
import QtQuick
import QtPositioning
import QtLocation
Map {
RouteModel {
id: routeModel
}
MapItemView {
model: routeModel
delegate: routeDelegate
}
Component {
id: routeDelegate
MapRoute {
route: routeData
line.color: "blue"
line.width: 5
smooth: true
opacity: 0.8
}
}
}Documentation des propriétés
add : Transition [since QtLocation 5.12]
Cette propriété contient la transition appliquée aux éléments de la carte créés par la vue lors de leur instanciation et de leur ajout à la carte.
Cette propriété a été introduite dans QtLocation 5.12.
autoFitViewport : bool
Cette propriété permet de déterminer s'il faut effectuer automatiquement un panoramique et un zoom dans la fenêtre d'affichage afin d'afficher tous les éléments de la carte lorsque des éléments sont ajoutés ou supprimés.
La valeur par défaut est « false ».
delegate : Component
Cette propriété contient le délégué qui définit la manière dont chaque élément du modèle doit être affiché. Le composant doit contenir exactement un objet dérivé de `MapItem` en tant qu'objet racine.
delegateModelAccess : enumeration [since 6.10]
Cette propriété détermine la manière dont les délégués peuvent accéder au modèle.
| Constante | Description |
|---|---|
DelegateModel.ReadOnly | Interdit aux délégués d'écrire dans le modèle via les propriétés de contexte, l'objet ` model ` ou les propriétés obligatoires. |
DelegateModel.ReadWrite | Autorise les délégués à modifier le modèle via les propriétés de contexte, l'objet ` model ` ou les propriétés obligatoires. |
DelegateModel.Qt5ReadWrite | Autorise les délégués à modifier le modèle via l'objet ` model ` et les propriétés de contexte, mais pas via les propriétés obligatoires. |
La valeur par défaut est ` DelegateModel.Qt5ReadWrite`.
Cette propriété a été introduite dans Qt 6.10.
Voir également Modèles et vues dans Qt Quick#Modification des données du modèle.
model : model
Cette propriété contient le modèle fournissant les données utilisées pour créer les éléments de la carte définis par le délégué. Seuls les modèles basés sur « QAbstractItemModel » sont pris en charge.
remove : Transition [since QtLocation 5.12]
Cette propriété contient la transition appliquée aux éléments de la carte créés par la vue lorsqu'ils sont supprimés.
Cette propriété a été introduite dans QtLocation 5.12.
© 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.