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: |
- Lista de todos los miembros, incluidos los heredados
- MapItemView forma parte del complemento QML Maps.
Propiedades
- add : Transition
(since QtLocation 5.12) - autoFitViewport : bool
- delegate : Component
- delegateModelAccess : enumeration
(since 6.10) - model : model
- remove : Transition
(since QtLocation 5.12)
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.
| Constante | Descripción |
|---|---|
DelegateModel.ReadOnly | Impide que los delegados escriban en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias. |
DelegateModel.ReadWrite | Permite a los delegados escribir en el modelo a través de las propiedades de contexto, el objeto ` model ` o las propiedades obligatorias. |
DelegateModel.Qt5ReadWrite | Permite 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.