En esta página

geoRectangle QML Value Type

El tipo geoRectangle representa un área geográfica rectangular. Más...

Import Statement: import QtPositioning

Propiedades

Descripción detallada

El tipo geoRectangle es un geoShape que representa un área geográfica rectangular. El tipo es la representación directa de un QGeoRectangle. Está definido por un par de coordinates que representan las esquinas superior izquierda e inferior derecha del rectángulo. Las coordenadas son accesibles desde los atributos topLeft y bottomRight.

Se considera que un rectángulo no es válido si las coordenadas superior izquierda o inferior derecha no son válidas o si la coordenada superior izquierda está al sur de la coordenada inferior derecha.

Se puede acceder a las coordenadas de las cuatro esquinas del rectángulo con los atributos topLeft, topRight, bottomLeft y bottomRight. El atributo center puede utilizarse para obtener la coordenada del centro del rectángulo. Los atributos width y height pueden utilizarse para obtener la anchura y la altura del rectángulo en grados. Al establecer uno de estos atributos, los demás se ajustarán en consecuencia.

Limitaciones

Un geoRectángulo nunca puede cruzar los polos.

Si la altura o el centro de un geoRectángulo se ajusta de forma que pueda cruzar uno de los polos, la altura se modifica de forma que el rectángulo toque pero no cruce el polo y que la coordenada central siga estando en el centro del rectángulo.

Ejemplo de uso

Para crear un valor geoRectangle, utilice la función QtPositioning.rectangle():

import QtPositioning

Item {
    property geoRectangle region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1),
                                                          QtPositioning.coordinate(-27.6, 153.2))
}

Al integrar con C++, tenga en cuenta que cualquier valor QGeoRectangle pasado a QML desde C++ se convierte automáticamente en un valor geoRectangle, y viceversa.

Documentación de propiedades

bottomLeft : geoCoordinate

Esta propiedad contiene la coordenada inferior izquierda de este geoRectangle.

bottomRight : geoCoordinate

Esta propiedad contiene la coordenada inferior derecha de este geoRectangle.

center : geoCoordinate

Esta propiedad contiene la coordenada central de este geoRectangle. Para más detalles, véase QGeoRectangle::setCenter().

height : double

Esta propiedad contiene la altura de este geoRectangle (en grados). Para más detalles ver QGeoRectangle::setHeight().

Nota: Si geoRectangle no es válido, no es posible establecer la altura. Las versiones de QtPositioning anteriores a Qt 5.5 permitían establecer la altura incluso en geoRectángulos no válidos.

topLeft : geoCoordinate

Esta propiedad contiene la coordenada superior izquierda de este geoRectangle.

topRight : geoCoordinate

Esta propiedad contiene la coordenada superior derecha de este geoRectangle.

width : double

Esta propiedad contiene la anchura de este geoRectangle (en grados). Para más detalles ver QGeoRectangle::setWidth().

Nota: Si geoRectangle no es válido, no es posible establecer la anchura. Las versiones de QtPositioning anteriores a Qt 5.5 permitían establecer la anchura incluso en geoRectangles no válidos.

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