QGeoCircle Class
La clase QGeoCircle define un área geográfica circular. Más información...
| Encabezado: | #include <QGeoCircle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Heredan: | QGeoShape |
Propiedades
Funciones públicas
| QGeoCircle() | |
| QGeoCircle(const QGeoShape &other) | |
| QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0) | |
| QGeoCircle(const QGeoCircle &other) | |
| ~QGeoCircle() | |
| QGeoCoordinate | center() const |
| void | extendCircle(const QGeoCoordinate &coordinate) |
| qreal | radius() const |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setRadius(qreal radius) |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoCircle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoCircle & | operator=(const QGeoCircle &other) |
Descripción detallada
El círculo se define mediante un ` QGeoCoordinate `, que especifica el centro del círculo, y un `qreal`, que especifica el radio del círculo en metros.
El círculo se considera inválido si la coordenada del centro es inválida o si el radio es menor que cero.
También se puede acceder a esta clase en QML como ` geoCircle`.
Documentación de propiedades
center : QGeoCoordinate
Esta propiedad contiene la coordenada del centro del círculo geográfico.
El círculo se considera no válido si esta propiedad contiene una coordenada no válida.
Un objeto ` QGeoCircle ` creado por defecto utiliza una ` QGeoCoordinate ` no válida como centro.
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:
radius : qreal
Esta propiedad contiene el radio del círculo en metros.
El círculo se considera no válido si esta propiedad es negativa.
Por defecto, el radio se inicializa con ` -1`.
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
QGeoCircle::QGeoCircle()
Crea un nuevo círculo geográfico no válido.
QGeoCircle::QGeoCircle(const QGeoShape &other)
Crea un nuevo círculo geométrico a partir del contenido de other.
QGeoCircle::QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0)
Crea un nuevo círculo geométrico con centro en center y un radio de radius metros.
QGeoCircle::QGeoCircle(const QGeoCircle &other)
Crea un nuevo círculo geométrico a partir del contenido de other.
[noexcept] QGeoCircle::~QGeoCircle()
Elimina este círculo geométrico.
QGeoCoordinate QGeoCircle::center() const
Devuelve la coordenada del centro de este círculo geográfico. Equivalente a ` QGeoShape::center()`.
Nota: Funcióngetter para la propiedad «center».
Véase también setCenter().
[invokable] void QGeoCircle::extendCircle(const QGeoCoordinate &coordinate)
Amplía el círculo geométrico para que también abarque la coordenada coordinate
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
qreal QGeoCircle::radius() const
Devuelve el radio, en metros, de este círculo geográfico.
Nota: Funcióngetter para la propiedad «radius».
Véase también setRadius().
void QGeoCircle::setCenter(const QGeoCoordinate ¢er)
Establece la coordenada central de este círculo geométrico en center.
Nota: Funciónde asignación para la propiedad center.
Véase también center().
void QGeoCircle::setRadius(qreal radius)
Establece el radio, en metros, de este círculo geométrico en radius.
Nota: Funciónde asignación para la propiedad radius.
Véase también ` radius()`.
[invokable] QString QGeoCircle::toString() const
Devuelve las propiedades del círculo geométrico como una cadena de caracteres.
Nota: Esta función se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoCircle::translate(double degreesLatitude, double degreesLongitude)
Traslada este círculo geométrico 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 se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QGeoCircle QGeoCircle::translated(double degreesLatitude, double degreesLongitude) const
Devuelve una copia de este círculo geográfico desplazado 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 se puede invocar a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
Véase también translate().
QGeoCircle &QGeoCircle::operator=(const QGeoCircle &other)
Asigna « other » a este círculo geográfico y devuelve una referencia a dicho círculo.
© 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.