En esta página

QGeoShape Class

La clase QGeoShape define un área geográfica. Más...

Cabecera: #include <QGeoShape>
CMake: find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake: QT += positioning
Heredado por:

QGeoCircle, QGeoPath, QGeoPolygon, y QGeoRectangle

Tipos públicos

enum ShapeType { UnknownType, RectangleType, CircleType, PathType, PolygonType }

Propiedades

Funciones públicas

QGeoShape()
QGeoShape(const QGeoShape &other)
~QGeoShape()
QGeoRectangle boundingGeoRectangle() const
QGeoCoordinate center() const
bool contains(const QGeoCoordinate &coordinate) const
bool isEmpty() const
bool isValid() const
QString toString() const
QGeoShape::ShapeType type() const
QGeoShape &operator=(const QGeoShape &other)
size_t qHash(const QGeoShape &shape, size_t seed = 0)
bool operator!=(const QGeoShape &lhs, const QGeoShape &rhs)
bool operator==(const QGeoShape &lhs, const QGeoShape &rhs)

Descripción detallada

Esta clase es la clase base para las clases que especifican un área geográfica.

En aras de la coherencia, las subclases deben describir los detalles específicos de las áreas asociadas en términos de instancias QGeoCoordinate y distancias en metros.

Esta clase también es accesible en QML como geoShape.

Documentación de tipos de miembros

enum QGeoShape::ShapeType

Describe el tipo de la forma.

ConstanteValorDescripción
QGeoShape::UnknownType0Forma de tipo desconocido
QGeoShape::RectangleType1Forma rectangular
QGeoShape::CircleType2Una forma circular
QGeoShape::PathType3Un tipo de trayectoria
QGeoShape::PolygonType4Un tipo de polígono

Documentación de propiedades

[read-only] center : QGeoCoordinate

Esta propiedad contiene la coordenada del centro geométrico de la forma.

Funciones de acceso:

QGeoCoordinate center() const

[read-only] isEmpty : bool

Esta propiedad define si esta geoforma está vacía.

Una geoforma vacía es una región que tiene un área geométrica de 0.

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:

bool isEmpty() const

[read-only] isValid : bool

Esta propiedad indica la validez de la geoforma.

Se considera que una geoforma no es válida si alguno de los datos necesarios para describirla de forma inequívoca no se ha establecido o se ha establecido con un valor inadecuado en función de la subclase de este objeto. Los objetos construidos por defecto de este tipo no son válidos.

Aunque esta propiedad se introduce en Qt 5.5, las funciones de acceso relacionadas existen desde la primera versión de esta clase.

Funciones de acceso:

bool isValid() const

[read-only] type : ShapeType

Esta propiedad contiene el tipo de esta geoforma.

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:

QGeoShape::ShapeType type() const

Documentación de funciones miembro

QGeoShape::QGeoShape()

Construye una nueva geoforma inválida de UnknownType.

[invokable] QGeoShape::QGeoShape(const QGeoShape &other)

Construye una nueva geoforma que es una copia de other.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

[noexcept] QGeoShape::~QGeoShape()

Destruye esta geoforma.

[invokable] QGeoRectangle QGeoShape::boundingGeoRectangle() const

Devuelve un QGeoRectangle que representa el rectángulo geográfico de la geoforma, que define los límites latitudinales/longitudinales de la geoforma.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QGeoCoordinate QGeoShape::center() const

Devuelve la coordenada situada en el centro geométrico de la geoforma.

Nota: Función Getter para la propiedad centro.

[invokable] bool QGeoShape::contains(const QGeoCoordinate &coordinate) const

Devuelve si la coordenada coordinate está contenida dentro de esta geoforma.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

bool QGeoShape::isEmpty() const

Devuelve si esta geoforma está vacía.

Una geoforma vacía es una región cuya área geométrica es 0.

Nota: Función Getter para la propiedad isEmpty.

bool QGeoShape::isValid() const

Devuelve si esta geoforma es válida.

Nota: Función Getter para la propiedad isValid.

[invokable] QString QGeoShape::toString() const

Devuelve una representación de cadena de esta geoforma.

Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.

QGeoShape::ShapeType QGeoShape::type() const

Devuelve el tipo de esta geoforma.

Nota: Función Getter para el tipo de propiedad.

QGeoShape &QGeoShape::operator=(const QGeoShape &other)

Asigna other a esta geoforma y devuelve una referencia a la misma.

No miembros relacionados

[noexcept] size_t qHash(const QGeoShape &shape, size_t seed = 0)

Devuelve el valor hash de shape, utilizando seed para el cálculo.

bool operator!=(const QGeoShape &lhs, const QGeoShape &rhs)

Devuelve true si la geoforma lhs no es equivalente a la geoforma rhs, en caso contrario devuelve false.

bool operator==(const QGeoShape &lhs, const QGeoShape &rhs)

Devuelve true si la geoforma lhs es equivalente a la geoforma rhs, en caso contrario devuelve false.

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