QGeoPolygon Class
La clase QGeoPolygon define un polígono geográfico. Más...
| Cabecera: | #include <QGeoPolygon> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Hereda: | QGeoShape |
Propiedades
- perimeter : QList<QGeoCoordinate>
Funciones públicas
| QGeoPolygon() | |
| QGeoPolygon(const QGeoShape &other) | |
| QGeoPolygon(const QList<QGeoCoordinate> &path) | |
| QGeoPolygon(const QGeoPolygon &other) | |
| ~QGeoPolygon() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | addHole(const QList<QGeoCoordinate> &holePath) |
| void | addHole(const QVariant &holePath) |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| const QVariantList | hole(qsizetype index) const |
| const QList<QGeoCoordinate> | holePath(qsizetype index) const |
| qsizetype | holesCount() const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
(since QtPositioning 5.12) const QList<QGeoCoordinate> & | perimeter() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | removeHole(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
(since QtPositioning 5.12) void | setPerimeter(const QList<QGeoCoordinate> &path) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPolygon | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoPolygon & | operator=(const QGeoPolygon &other) |
Descripción detallada
El polígono está definido por una lista ordenada de objetos QGeoCoordinate que representan su perímetro.
Se pretende que cada dos elementos adyacentes de esta lista estén conectados entre sí por el segmento de línea más corto de rumbo constante que pase por ambos elementos. Este tipo de conexión puede cruzar la línea de fecha en la dirección longitudinal, pero nunca cruza los polos.
Esto es relevante para el cálculo del cuadro delimitador devuelto por QGeoShape::boundingGeoRectangle() para esta forma, que tendrá la latitud de la esquina superior izquierda fijada en la latitud máxima en el conjunto de puntos de la trayectoria. Del mismo modo, la latitud de la esquina inferior derecha será la latitud mínima del conjunto de puntos del recorrido.
Esta clase también es accesible en QML como geoPolygon.
Documentación de propiedades
perimeter : QList<QGeoCoordinate>
Esta propiedad contiene las coordenadas del perímetro del polígono.
Funciones de acceso:
| const QList<QGeoCoordinate> & | perimeter() const |
| void | setPerimeter(const QList<QGeoCoordinate> &path) |
Documentación de funciones miembro
QGeoPolygon::QGeoPolygon()
Construye un nuevo geopolígono vacío.
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
Construye un nuevo geopolígono a partir del contenido de other.
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
Construye un nuevo geopolígono a partir de las coordenadas especificadas en path.
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
Construye un nuevo geopolígono a partir del contenido de other.
[noexcept] QGeoPolygon::~QGeoPolygon()
Destruye este polígono.
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
Añade coordinate al polígono.
Nota: Esta función puede invocarse a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
Método sobrecargado. Establece el holePath para un agujero dentro del polígono. El agujero es un QList<QGeoCoordinate>.
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
Establece el holePath para un agujero dentro del polígono. El agujero es un QVariant que contiene un QList<QGeoCoordinate>.
Nota: Esta función puede ser invocada a través del sistema de meta-objetos y desde QML. Véase Q_INVOKABLE.
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
Devuelve true si el perímetro del polígono contiene coordinate como uno de los elementos.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPolygon::coordinateAt(qsizetype index) const
Devuelve la coordenada en index.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] const QVariantList QGeoPolygon::hole(qsizetype index) const
Devuelve un QVariant que contiene un QList<QGeoCoordinate> que representa el agujero en index.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
Devuelve un QList<QGeoCoordinate> que representa el agujero en index.
[invokable] qsizetype QGeoPolygon::holesCount() const
Devuelve el número de agujeros.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPolygon::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Inserta coordinate en el index especificado.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] double QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Devuelve la longitud del perímetro del polígono, en metros, desde el elemento indexFrom hasta el elemento indexTo. Se pretende que la longitud sea la suma de las distancias más cortas para cada par de puntos adyacentes.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const
Devuelve todos los elementos del perímetro del polígono.
Nota: Función Getter para la propiedad perímetro.
Esta función se introdujo en QtPositioning 5.12.
Véase también setPerimeter().
[invokable] void QGeoPolygon::removeCoordinate(const QGeoCoordinate &coordinate)
Elimina la última aparición de coordinate del polígono.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPolygon::removeCoordinate(qsizetype index)
Elimina del polígono el elemento situado en la posición index.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPolygon::removeHole(qsizetype index)
Elimina el elemento en la posición index de la lista de huecos.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPolygon::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Sustituye el elemento path en la dirección index especificada por coordinate.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
Establece el perímetro del polígono basándose en una lista de coordenadas path.
Nota: Función Setter para la propiedad perimeter.
Esta función se introdujo en QtPositioning 5.12.
Véase también perimeter().
[invokable] qsizetype QGeoPolygon::size() const
Devuelve el número de elementos del polígono.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] QString QGeoPolygon::toString() const
Devuelve las propiedades del geopolígono como una cadena.
Nota: Esta función puede invocarse a través del sistema de metaobjetos y desde QML. Véase Q_INVOKABLE.
[invokable] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
Traslada este geopolígono 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.
[invokable] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
Devuelve una copia de este geopolígono trasladado por degreesLatitude hacia el norte y degreesLongitude hacia el este.
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().
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
Asigna other a este geopolígono y devuelve una referencia a este geopolígono.
© 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.
