MapItemGroup QML Type
El tipo MapItemGroup es un contenedor de elementos de mapa. Más...
| Import Statement: | import QtLocation 6.11 |
| Since: | QtLocation 5.9 |
- Lista de todos los miembros, incluyendo los heredados
- MapItemGroup es parte de QML Maps Plugin.
Descripción detallada
Su propósito es permitir la modularización del código permitiendo el uso de archivos qml que contengan elementos de mapa relacionados entre sí, y los bindings asociados.
Nota: El lanzamiento de esta API con Qt 5.9 es una Muestra de Tecnología.
Ejemplo de uso
El siguiente fragmento muestra cómo utilizar un MapItemGroup para crear un MapCircle, centrado en la coordenada (63, -18) con un radio de 100km, relleno en rojo, rodeado de un borde verde ondulado, ambos contenidos en un círculo azul semitransparente con un MouseArea que mueve todo el grupo. Este grupo se define en un archivo separado llamado PolygonGroup.qml:
import QtQuick import QtPositioning import QtLocation MapItemGroup { id: itemGroup property alias position: mainCircle.center property var radius: 100 * 1000 property var borderHeightPct : 0.3 MapCircle { id: mainCircle center : QtPositioning.coordinate(40, 0) radius: itemGroup.radius * (1.0 + borderHeightPct) opacity: 0.05 visible: true color: 'blue' MouseArea{ anchors.fill: parent drag.target: parent id: maItemGroup } } MapCircle { id: groupCircle center: itemGroup.position radius: itemGroup.radius color: 'crimson' onCenterChanged: { groupPolyline.populateBorder(); } } MapPolyline { id: groupPolyline line.color: 'green' line.width: 3 function populateBorder() { groupPolyline.path = [] // clearing the path var waveLength = 8.0; var waveAmplitude = groupCircle.radius * borderHeightPct; for (var i=0; i <= 360; i++) { var wavePhase = (i/360.0 * 2.0 * Math.PI )* waveLength var waveHeight = (Math.cos(wavePhase) + 1.0) / 2.0 groupPolyline.addCoordinate(groupCircle.center.atDistanceAndAzimuth(groupCircle.radius + waveAmplitude * waveHeight , i)) } } Component.onCompleted: { populateBorder() } } }
PolygonGroup.qml es ahora un componente reutilizable que luego puede ser utilizado en un Mapa como:
Map { id: map PolygonGroup { id: polygonGroup position: QtPositioning.coordinate(63,-18) } }

© 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.