En esta página

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 &center, qreal radius = -1.0)
QGeoCircle(const QGeoCircle &other)
~QGeoCircle()
QGeoCoordinate center() const
void extendCircle(const QGeoCoordinate &coordinate)
qreal radius() const
void setCenter(const QGeoCoordinate &center)
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:

QGeoCoordinate center() const
void setCenter(const QGeoCoordinate &center)

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:

qreal radius() const
void setRadius(qreal radius)

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 &center, 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 &center)

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.