MapPolygon QML Type

El tipo MapPolygon muestra un polígono en un Mapa. Más...

• Lista de todos los miembros, incluyendo los heredados
• MapPolygon es parte de QML Maps Plugin.

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 en términos de una lista ordenada de coordinates. Para una mejor apariencia y resultados, los polígonos deben ser simples (no auto-interseccionados).

Las coordenadas pueden añadirse o eliminarse en cualquier momento mediante los métodos addCoordinate y removeCoordinate. También pueden modificarse como cualquier otro elemento de lista en QML:

mapPolygon.path[0].latitude = 5;

Para dibujar rectángulos con bordes "rectos" (misma latitud en un borde, misma latitud en el otro), el tipo MapRectangle proporciona una API más simple, de dos puntos.

Por defecto, el polígono se muestra con un borde negro de 1 píxel sin relleno. Para cambiar su apariencia, utilice las propiedades color, border.color y border.width.

Ejemplo de uso

El siguiente fragmento muestra un MapPolygon utilizado para mostrar un triángulo con tres vértices cerca de Brisbane, Australia. El triángulo se rellena en verde, con 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 establece si el elemento se desvanece automáticamente al hacer zoom en el mapa a partir de niveles de zoom muy bajos. Por defecto es true. Establecer esta propiedad a false hace que el elemento del mapa tenga siempre la opacidad especificada con la propiedad QtQuick::Item::opacity, que por defecto es 1.0.

border group

Esta propiedad forma parte del grupo de propiedades borde. El grupo de propiedades de borde contiene la anchura y el color utilizados para dibujar el borde del polígono.

La anchura se expresa en píxeles y es independiente del nivel de zoom del mapa.

Los valores por defecto corresponden a un borde negro con una anchura de 1 píxel. Para que no haya borde, utilice una anchura de 0 o un color transparente.

color : color

Esta propiedad contiene 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. Tener menos de 3 coordenadas diferentes en el trazado resulta en 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 de los polígonos se conectan con líneas rectas en el mapa. Si se establece en QLocation::ReferenceSurface::Globe, los vértices se conectan siguiendo el camino del gran círculo, que describe la conexión más corta de 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 la dirección coordinate especificada a la ruta.

Véase también removeCoordinate y path.

void removeCoordinate(coordinate)

Elimina coordinate de la ruta. Si hay varias instancias de 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.