QGeoRectangle Class
La clase QGeoRectangle define un área geográfica rectangular. Más...
| Cabecera: | #include <QGeoRectangle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Hereda: | QGeoShape |
Propiedades
|
Funciones públicas
| QGeoRectangle() | |
| QGeoRectangle(const QGeoShape &other) | |
| QGeoRectangle(const QList<QGeoCoordinate> &coordinates) | |
| QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight) | |
| QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight) | |
| QGeoRectangle(const QGeoRectangle &other) | |
| ~QGeoRectangle() | |
| QGeoCoordinate | bottomLeft() const |
| QGeoCoordinate | bottomRight() const |
| QGeoCoordinate | center() const |
| bool | contains(const QGeoRectangle &rectangle) const |
| void | extendRectangle(const QGeoCoordinate &coordinate) |
| double | height() const |
| bool | intersects(const QGeoRectangle &rectangle) const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setHeight(double degreesHeight) |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
| void | setTopRight(const QGeoCoordinate &topRight) |
| void | setWidth(double degreesWidth) |
| QString | toString() const |
| QGeoCoordinate | topLeft() const |
| QGeoCoordinate | topRight() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoRectangle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoRectangle | united(const QGeoRectangle &rectangle) const |
| double | width() const |
| QGeoRectangle & | operator=(const QGeoRectangle &other) |
| QGeoRectangle | operator|(const QGeoRectangle &rectangle) const |
| QGeoRectangle & | operator|=(const QGeoRectangle &rectangle) |
Descripción detallada
El rectángulo se define en términos de un QGeoCoordinate que especifica la coordenada superior izquierda del rectángulo y un QGeoCoordinate que especifica la coordenada inferior derecha del rectángulo.
Un georrectángulo se considera invá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.
Los georrectángulos nunca pueden cruzar los polos.
Varios métodos se comportan como si el georrectángulo estuviera definido en términos de una coordenada central, la anchura del georrectángulo en grados y la altura del georrectángulo en grados.
Si la altura o el centro de un georrectángulo se ajusta de forma que cruce uno de los polos, la altura se modifica de forma que el georrectángulo toque pero no cruce el polo y que la coordenada central siga estando en el centro del georrectángulo.
Esta clase también es accesible en QML como geoRectangle.
Documentación de propiedades
bottomLeft : QGeoCoordinate
Esta propiedad contiene la coordenada inferior izquierda de este geo rectángulo.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| QGeoCoordinate | bottomLeft() const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
Esta propiedad contiene la coordenada inferior derecha de este geo rectángulo.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| QGeoCoordinate | bottomRight() const |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
Esta propiedad contiene el centro de este geo rectángulo.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
Véase también QGeoShape::center.
height : double
Esta propiedad contiene la altura de este geo rectángulo en grados.
El valor de la propiedad es indefinido si este geo rectángulo no es válido.
Si la nueva altura es menor que 0.0 o si este geo rectángulo no es válido, la propiedad no se modifica. Para establecer los valores de un geo rectángulo inválido basándose en el centro, la anchura y la altura, primero debe utilizar setCenter() para que el geo rectángulo sea válido.
Si el cambio en la altura provocara que el georrectángulo cruzara un poste, la altura se ajusta de forma que el georrectángulo sólo toque el poste.
Este cambio se realiza de forma que la coordenada central siga estando en el centro del georrectángulo, lo que puede dar como resultado un georrectángulo con una altura menor de la esperada.
180.0 es la altura utilizada sólo si la nueva altura es mayor o igual que 180.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
topLeft : QGeoCoordinate
Esta propiedad contiene la coordenada superior izquierda de este geo rectángulo.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| QGeoCoordinate | topLeft() const |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
Esta propiedad contiene la coordenada superior derecha de este geo rectángulo.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
| QGeoCoordinate | topRight() const |
| void | setTopRight(const QGeoCoordinate &topRight) |
width : double
Esta propiedad contiene el ancho de este geo rectángulo en grados.
El valor de la propiedad es indefinido si este geo rectángulo no es válido.
Si la nueva anchura es menor que 0.0 o si este geo rectángulo no es válido, esta función no hace nada. Para establecer los valores de un geo rectángulo inválido basado en el centro, anchura y altura, debe utilizar setCenter() primero para hacer que el geo rectángulo sea válido.
360.0 es la anchura utilizada sólo si la nueva anchura es igual o mayor que 360. En tales casos, la longitud más a la izquierda del geo rectángulo se establece en -180,0 grados y la longitud más a la derecha del geo rectángulo se establece en 180,0 grados.
Aunque esta propiedad se introdujo en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.
Funciones de acceso:
Documentación de funciones miembro
QGeoRectangle::QGeoRectangle()
Construye un nuevo georrectángulo no válido.
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
Construye un georrectángulo a partir del contenido de other.
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
Construye un nuevo georrectángulo, de tamaño mínimo, que contiene todos los coordinates.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
Construye un nuevo geo rectángulo con una coordenada superior izquierda topLeft y una coordenada inferior derecha bottomRight.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
Construye un nuevo georrectángulo centrado en center con una anchura en grados de degreesWidth y una altura en grados de degreesHeight.
Si degreesHeight llevara el georrectángulo más allá de uno de los polos, la altura del georrectángulo se truncará de forma que el georrectángulo sólo se extienda hasta el polo. El centro del georrectángulo no cambiará y la altura se ajustará de forma que el punto central se encuentre en el centro del georrectángulo truncado.
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
Construye un georrectángulo a partir del contenido de other.
[noexcept] QGeoRectangle::~QGeoRectangle()
Destruye este geo rectángulo.
QGeoCoordinate QGeoRectangle::bottomLeft() const
Devuelve la coordenada inferior izquierda de este geo rectángulo.
Nota: Función Getter para la propiedad bottomLeft.
Véase también setBottomLeft().
QGeoCoordinate QGeoRectangle::bottomRight() const
Devuelve la coordenada inferior derecha de este geo rectángulo.
Nota: Función Getter para la propiedad bottomRight.
Véase también setBottomRight().
QGeoCoordinate QGeoRectangle::center() const
Devuelve el centro de este geo rectángulo. Equivalente a QGeoShape::center().
Nota: Función Getter para la propiedad center.
Véase también setCenter().
bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const
Devuelve si el georrectángulo rectangle está contenido en este georrectángulo.
[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
Extiende el geo rectángulo para cubrir también la coordenada coordinate
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
double QGeoRectangle::height() const
Devuelve la altura de este georrectángulo en grados.
El valor devuelto es indefinido si este geo rectángulo no es válido.
Nota: Función Getter para la propiedad height.
Véase también setHeight().
[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const
Devuelve si el georrectángulo rectangle interseca este georrectángulo.
Si los bordes superior o inferior de ambos geo rectángulos están en uno de los polos, se considera que los geo rectángulos se intersecan, ya que la longitud es irrelevante cuando los bordes están en el polo.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
Establece la coordenada inferior izquierda de este georrectángulo en bottomLeft.
Nota: Función Setter para la propiedad bottomLeft.
Véase también bottomLeft().
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
Establece la coordenada inferior derecha de este georrectángulo en bottomRight.
Nota: Función Setter para la propiedad bottomRight.
Véase también bottomRight().
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
Establece el centro de este georrectángulo en center.
Si esto hace que el georrectángulo cruce uno de los polos, la altura del georrectángulo se truncará de forma que el georrectángulo sólo se extienda hasta el polo. El centro del georrectángulo no cambiará y la altura se ajustará de forma que el punto central se encuentre en el centro del georrectángulo truncado.
Nota: Función Setter para la propiedad center.
Véase también center().
void QGeoRectangle::setHeight(double degreesHeight)
Establece la altura de este geo rectángulo en grados a degreesHeight.
Nota: Función Setter para la propiedad height.
Véase también height().
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
Establece la coordenada superior izquierda de este georrectángulo en topLeft.
Nota: Función Setter para la propiedad topLeft.
Véase también topLeft().
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
Establece la coordenada superior derecha de este georrectángulo en topRight.
Nota: Función Setter para la propiedad topRight.
Véase también topRight().
void QGeoRectangle::setWidth(double degreesWidth)
Establece la anchura de este geo rectángulo en grados a degreesWidth.
Nota: Función Setter para la propiedad width.
Véase también width().
[invokable] QString QGeoRectangle::toString() const
Devuelve las propiedades del geo rectángulo como una cadena.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
QGeoCoordinate QGeoRectangle::topLeft() const
Devuelve la coordenada superior izquierda de este geo rectángulo.
Nota: Función Getter para la propiedad topLeft.
Véase también setTopLeft().
QGeoCoordinate QGeoRectangle::topRight() const
Devuelve la coordenada superior derecha de este geo rectángulo.
Nota: Función Getter para la propiedad topRight.
Véase también setTopRight().
[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
Traslada este georrectángulo degreesLatitude hacia el norte y degreesLongitude hacia el este.
Los valores negativos de degreesLatitude y degreesLongitude corresponden a una traslación hacia el sur y hacia el oeste respectivamente.
Si la traslación hubiera provocado que el georrectángulo cruzara un polo, el georrectángulo se trasladará hasta que el borde superior o inferior del georrectángulo toque el polo, pero no más allá.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
Devuelve una copia de este geo rectángulo trasladado por degreesLatitude hacia el norte y degreesLongitude hacia el este.
Los valores negativos de degreesLatitude y degreesLongitude corresponden a una traslación hacia el sur y hacia el oeste respectivamente.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también translate().
[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.
Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para asegurar que el resultado es independiente del orden de los operandos.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
double QGeoRectangle::width() const
Devuelve la anchura de este georrectángulo en grados.
El valor devuelto es indefinido si este geo rectángulo no es válido.
Nota: Función Getter para la propiedad width.
Véase también setWidth().
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
Asigna other a este geo rectángulo y devuelve una referencia a este geo rectángulo.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.
Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para garantizar que el resultado es independiente del orden de los operandos.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
Devuelve el georrectángulo más pequeño que contiene este georrectángulo y rectangle.
Si los centros de los dos georrectángulos están separados exactamente 180,0 grados, la anchura se establece en 360,0 grados con la longitud más a la izquierda establecida en -180,0 grados y la longitud más a la derecha establecida en 180,0 grados. Esto se hace para garantizar que el resultado es independiente del orden de los operandos.
© 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.