MapRectangle QML Type

El tipo MapRectangle muestra un rectángulo en un Mapa. Más...

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

Propiedades

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• bottomRight : coordinate
• color : color
• opacity : real
• referenceSurface : enum (since 6.5)
• topLeft : coordinate

Descripción detallada

El tipo MapRectangle muestra un rectángulo en un Mapa. Los rectángulos son un caso especial de polígono con exactamente 4 vértices y 4 bordes "rectos". En este caso, "recto" significa que el punto superior izquierdo tiene la misma latitud que el punto superior derecho (la arista superior), y el punto inferior izquierdo tiene la misma latitud que el punto inferior derecho (la arista inferior). Del mismo modo, los puntos del lado izquierdo tienen la misma longitud, y los puntos del lado derecho tienen la misma longitud.

Para especificar el rectángulo, se requiere un punto topLeft y bottomRight, ambos dados por una coordenada.

Por defecto, el rectángulo se muestra con relleno transparente y un borde negro de 1 píxel de grosor. Esto puede cambiarse utilizando las propiedades color, border.color y border.width.

Ejemplo de uso

El siguiente fragmento muestra un mapa que contiene un MapRectangle, que abarca desde (-27, 153) hasta (-28, 153,5), cerca de Brisbane, Australia. El rectángulo está relleno en verde, con un borde negro de 2 píxeles.

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            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 rectángulo. 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.

bottomRight : coordinate

Esta propiedad contiene la coordenada inferior derecha de MapRectangle que puede utilizarse para recuperar su longitud, latitud y altitud.

color : color

Esta propiedad contiene el color de relleno del rectángulo. Para no rellenar, utilice un color transparente.

opacity : real

Esta propiedad contiene la opacidad del elemento. La opacidad se especifica como un número entre 0 (totalmente transparente) y 1 (totalmente opaco). El valor por defecto es 1.

Un elemento con opacidad 0 seguirá recibiendo eventos de ratón. Para detener los eventos del ratón, establezca la propiedad visible del elemento a false.

referenceSurface : enum [since 6.5]

Esta propiedad determina la superficie de referencia del rectángulo. Si se establece en QLocation::ReferenceSurface::Map los puntos de borde se conectan con líneas rectas en el mapa. Si se establece en QLocation::ReferenceSurface::Globe, los puntos de borde 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.

topLeft : coordinate

Esta propiedad contiene la coordenada superior izquierda de MapRectangle que puede utilizarse para recuperar su longitud, latitud y altitud.