MapRectangle QML Type
El tipo MapRectangle muestra un rectángulo 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
- MapRectangle forma parte del complemento QML Maps.
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 aristas «rectas». En este caso, «recto» significa que el punto superior izquierdo tiene la misma latitud que el punto superior derecho (el borde superior), y que el punto inferior izquierdo tiene la misma latitud que el punto inferior derecho (el borde 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 un punto « bottomRight », ambos definidos mediante un « geoCoordinate ».
Por defecto, el rectángulo se muestra con relleno transparente y un borde negro de 1 píxel de grosor. Esto se puede modificar utilizando las propiedades color, border.color y border.width.
Nota: Al igual que el tipo « MapPolygon », los «MapRectangles» son elementos geográficos, por lo que al arrastrar un «MapRectangle» se recalculan sus vértices en el espacio de coordenadas geográficas. Se produce un estiramiento aparente del elemento cuando se arrastra a una latitud diferente; sin embargo, sus bordes permanecen rectos.
Ejemplo de uso
El siguiente fragmento de código 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 de 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 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 rectángulo. 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.
bottomRight : coordinate
Esta propiedad contiene la coordenada de la esquina inferior derecha del « MapRectangle », que puede utilizarse para obtener su longitud, latitud y altitud.
color : color
Esta propiedad determina el color de relleno del rectángulo. Si no quieres que haya relleno, utiliza un color transparente.
opacity : real
Esta propiedad determina la opacidad del elemento. La opacidad se especifica como un número comprendido entre 0 (totalmente transparente) y 1 (totalmente opaco). El valor por defecto es 1.
Un elemento con opacidad 0 seguirá recibiendo eventos del ratón. Para detener los eventos del ratón, establece la propiedad «visible» del elemento en «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 los bordes se conectan con líneas rectas en el mapa. Si se establece en « QLocation::ReferenceSurface::Globe », los puntos de los bordes 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.
topLeft : coordinate
Esta propiedad contiene la coordenada superior izquierda del objeto « MapRectangle », que puede utilizarse para obtener su longitud, latitud y altitud.
© 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.