MapPolygon QML Type
El tipo MapPolygon muestra un polígono en un mapa. Más información...
| Import Statement: | import QtLocation 6.12 |
| Since: | QtLocation 5.5 |
- Lista de todos los miembros, incluidos los heredados
- MapPolygon forma parte del complemento QML Maps.
Propiedades
- autoFadeIn : bool
- border
- border.color : color
- border.width : int
- color : color
- path : list<coordinate>
- referenceSurface : enum
(since 6.5)
Métodos
- void addCoordinate(coordinate)
- void removeCoordinate(coordinate)
Descripción detallada
El tipo MapPolygon muestra un polígono en un mapa, especificado mediante una lista ordenada de coordinates. Para obtener los mejores resultados y una mejor apariencia, los polígonos deben ser simples (sin intersecciones internas).
Las coordenadas se pueden añadir o eliminar en cualquier momento mediante los métodos ` addCoordinate ` y ` removeCoordinate `. También se pueden modificar como cualquier otro elemento de lista en QML:
mapPolygon.path[0].latitude = 5;Para dibujar rectángulos con bordes «rectos» (la misma latitud a lo largo de un borde y la misma latitud a lo largo del otro), el tipo ` MapRectangle ` ofrece una API más sencilla de dos puntos.
Por defecto, el polígono se muestra como un borde negro de 1 píxel sin relleno. Para cambiar su apariencia, utiliza las propiedades color, border.color y border.width.
Nota: Dado que los MapPolygons son elementos geográficos, al arrastrar un MapPolygon (mediante el uso de MouseArea o PointHandler) se recalculan sus vértices en el espacio de coordenadas geográficas. Los bordes conservan las mismas longitudes geográficas (diferencias de latitud y longitud entre los vértices), pero siguen siendo rectos. Se produce un estiramiento aparente del elemento cuando se arrastra a una latitud diferente.
Ejemplo de uso
El siguiente fragmento de código muestra cómo se utiliza un MapPolygon para representar un triángulo con tres vértices cerca de Brisbane, Australia. El triángulo está relleno de color verde y tiene un borde negro de 1 píxel.
Map {
MapPolygon {
color: 'green'
path: [
{ latitude: -27, longitude: 153.0 },
{ latitude: -27, longitude: 154.1 },
{ latitude: -28, longitude: 153.5 }
]
}
}
Documentación de propiedades
autoFadeIn : bool
Esta propiedad determina si el elemento aparece gradualmente al ampliar el mapa partiendo de niveles de zoom muy bajos. Por defecto, el valor es « true ». Si se establece esta propiedad en « false », el elemento del mapa tendrá siempre la opacidad especificada con la propiedad « QtQuick::Item::opacity », cuyo valor por defecto es 1,0.
border group
Esta propiedad forma parte del grupo de propiedades «border». El grupo de propiedades «border» contiene el ancho y el color que se utilizan para dibujar el borde del polígono.
El ancho se expresa en píxeles y es independiente del nivel de zoom del mapa.
Los valores por defecto corresponden a un borde negro con un ancho de 1 píxel. Para que no aparezca ninguna línea, utiliza un ancho de 0 o un color transparente.
color : color
Esta propiedad indica el color utilizado para rellenar el polígono.
El valor por defecto es transparente.
path : list<coordinate>
Esta propiedad contiene la lista ordenada de coordenadas que definen el polígono. Si la ruta tiene menos de 3 coordenadas diferentes, se produce un comportamiento indefinido.
Véase también addCoordinate y removeCoordinate.
referenceSurface : enum [since 6.5]
Esta propiedad determina la superficie de referencia del polígono. Si se establece en « QLocation::ReferenceSurface::Map », los vértices del polígono se conectan con líneas rectas en el mapa. Si se establece en « QLocation::ReferenceSurface::Globe », los vértices se conectan siguiendo la trayectoria del gran círculo, que describe la conexión más corta entre dos puntos en una esfera. El valor por defecto es « QLocation::ReferenceSurface::Map ».
Esta propiedad se introdujo en Qt 6.5.
Documentación del método
void addCoordinate(coordinate)
Añade el archivo « coordinate » especificado a la ruta.
Véase también removeCoordinate y path.
void removeCoordinate(coordinate)
Elimina « coordinate » de la ruta. Si hay varias entradas con la misma coordenada, se elimina la que se haya añadido en último lugar.
Si coordinate no está en la ruta, este método no hace nada.
Véase también addCoordinate y path.
© 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.