En esta página

MapItemView QML Type

MapItemView se utiliza para rellenar el mapa a partir de un modelo. Más información...

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

QtObject

Propiedades

Descripción detallada

MapItemView se utiliza para rellenar un Map con MapItems procedentes de un modelo. El tipo MapItemView solo tiene sentido cuando está contenido en un Map, 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 debe desplazar y ampliar automáticamente la ventana de visualización para mostrar todos los elementos del mapa cuando se añaden o se eliminan elementos.

El valor 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 pueden acceder los delegados al modelo.

ConstanteDescripción
DelegateModel.ReadOnlyImpide que los delegados escriban en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias.
DelegateModel.ReadWritePermite a los delegados escribir en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias.
DelegateModel.Qt5ReadWritePermite a los delegados escribir en el modelo a través del objeto ` model ` y de las propiedades de contexto, pero no a través de las propiedades obligatorias.

El valor predeterminado es ` DelegateModel.Qt5ReadWrite`.

Esta propiedad se introdujo en Qt 6.10.

Véase también «Modelos y vistas» en Qt Quick, apartado «Modificación de los datos del modelo».

model : model

Esta propiedad contiene el modelo que proporciona los datos utilizados para crear los elementos del mapa definidos por el delegado. Solo 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.