En esta página

QGeoShape Class

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

Encabezado: #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 de « QGeoCoordinate » y distancias en metros.

También se puede acceder a esta clase en QML como « geoShape ».

Documentación sobre los tipos de miembros

enum QGeoShape::ShapeType

Describe el tipo de la figura.

ConstanteValorDescripción
QGeoShape::UnknownType0Una forma de tipo desconocido
QGeoShape::RectangleType1Una forma rectangular
QGeoShape::CircleType2Una forma circular
QGeoShape::PathType3Un tipo de trazado
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 figura.

Funciones de acceso:

QGeoCoordinate center() const

[read-only] isEmpty : bool

Esta propiedad define si esta forma geográfica está vacía.

Una forma geométrica vacía es una región cuyo área geométrica es 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 forma geográfica.

Una forma geográfica se considera inválida si algunos de los datos necesarios para describirla de forma inequívoca no se han establecido o se han establecido con un valor inadecuado, dependiendo de la subclase de este objeto. Los objetos de este tipo creados por defecto son inválidos.

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 isValid() const

[read-only] type : ShapeType

Esta propiedad contiene el tipo de esta forma geográfica.

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 las funciones miembro

QGeoShape::QGeoShape()

Crea una nueva forma geométrica no válida de UnknownType.

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

Crea una nueva forma geométrica que es una copia de other.

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

[noexcept] QGeoShape::~QGeoShape()

Elimina esta figura geométrica.

[invokable] QGeoRectangle QGeoShape::boundingGeoRectangle() const

Devuelve un objeto ` QGeoRectangle ` que representa el rectángulo delimitador geográfico de la forma geográfica, el cual define los límites de latitud y longitud de dicha forma.

Nota: Esta función se puede invocar 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 figura geométrica.

Nota: Funcióngetter para la propiedad «center».

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

Devuelve si la coordenada coordinate está dentro de esta forma geográfica.

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

bool QGeoShape::isEmpty() const

Devuelve si esta forma geográfica está vacía.

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

Nota: Funcióngetter para la propiedad isEmpty.

bool QGeoShape::isValid() const

Devuelve si esta forma geográfica es válida.

Nota: Funcióngetter para la propiedad isValid.

[invokable] QString QGeoShape::toString() const

Devuelve una representación en forma de cadena de esta forma geométrica.

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

QGeoShape::ShapeType QGeoShape::type() const

Devuelve el tipo de esta forma geográfica.

Nota: Funcióngetter para la propiedad «type».

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

Asigna un objeto « other » a esta figura geométrica y devuelve una referencia a dicha figura.

Elementos 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 forma geográfica de lhs no es equivalente a la de rhs; en caso contrario, devuelve « false ».

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

Devuelve « true » si la forma geográfica de lhs es equivalente a la de 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.