Sur cette page

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:

QtObject

Propriétés

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.

ConstanteDescription
DelegateModel.ReadOnlyInterdit 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.ReadWriteAutorise 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.Qt5ReadWriteAutorise 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.