En esta página

MapItemView QML Type

El MapItemView se utiliza para rellenar el Mapa a partir de un modelo. Más...

Import Statement: import QtLocation 6.11
Since: QtLocation 5.5
Inherits:

QtObject

Propiedades

Descripción detallada

El MapItemView se utiliza para rellenar Mapas con MapItems de un modelo. El tipo MapItemView sólo tiene sentido cuando está contenido en un Mapa, lo que significa que no tiene una presentación independiente.

Ejemplo de uso

Este ejemplo muestra cómo utilizar el objeto MapViewItem para mostrar un route en un 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
        }
    }
}

Documentación de Propiedades

add : Transition [since QtLocation 5.12]

Esta propiedad contiene la transición que se aplica a los elementos del mapa creados por la vista cuando se instancian y se añaden al mapa.

Esta propiedad se introdujo en QtLocation 5.12.

autoFitViewport : bool

Esta propiedad controla si se realiza automáticamente la panorámica y el zoom de la ventana gráfica para mostrar todos los elementos del mapa cuando se añaden o eliminan elementos.

Por defecto es false.

delegate : Component

Esta propiedad contiene el delegado que define cómo debe mostrarse cada elemento del modelo. El Componente debe contener exactamente un objeto derivado de MapItem como objeto raíz.

delegateModelAccess : enumeration [since 6.10]

Esta propiedad determina cómo los delegados pueden acceder al modelo.

ConstanteDescripción
DelegateModel.ReadOnlyProhíbe a los delegados escribir el modelo a través de las propiedades de contexto, el objeto model o las propiedades requeridas.
DelegateModel.ReadWritePermite a los delegados escribir el modelo a través de las propiedades de contexto, el objeto model o las propiedades requeridas.
DelegateModel.Qt5ReadWritePermitir a los delegados escribir el modelo a través del objeto model y las propiedades de contexto, pero no a través de las propiedades requeridas.

El valor por defecto es DelegateModel.Qt5ReadWrite.

Esta propiedad se introdujo en Qt 6.10.

Ver también Modelos y Vistas en Qt Quick#CambiandoDatos del Modelo.

model : model

Esta propiedad contiene el modelo que proporciona los datos utilizados para crear los elementos del mapa definidos por el delegado. Sólo se admiten modelos basados en QAbstractItemModel.

remove : Transition [since QtLocation 5.12]

Esta propiedad contiene la transición que se aplica a los elementos del mapa creados por la vista cuando se eliminan.

Esta propiedad se introdujo en 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.