QGeoPolygon Class
La classe QGeoPolygon définit un polygone géographique. En savoir plus...
| En-tête : | #include <QGeoPolygon> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
| Hérite de : | QGeoShape |
Propriétés
- perimeter : QList<QGeoCoordinate>
Fonctions publiques
| 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) |
Description détaillée
Le polygone est défini par une liste ordonnée d'objets « QGeoCoordinate » représentant son périmètre.
Deux éléments adjacents de cette liste sont censés être reliés entre eux par le segment de droite le plus court, de cap constant, passant par ces deux éléments. Ce type de liaison peut traverser la ligne de changement de date dans le sens longitudinal, mais ne traverse jamais les pôles.
Ceci est pertinent pour le calcul du rectangle englobant renvoyé par la fonction QGeoShape::boundingGeoRectangle() pour cette forme, dont la latitude du coin supérieur gauche sera définie sur la latitude maximale de l’ensemble des points de chemin. De même, la latitude du coin inférieur droit correspondra à la latitude minimale de l’ensemble des points de chemin.
Cette classe est également accessible en QML sous le nom geoPolygon.
Documentation des propriétés
perimeter : QList<QGeoCoordinate>
Cette propriété contient les coordonnées du périmètre du polygone.
Fonctions d'accès :
| const QList<QGeoCoordinate> & | perimeter() const |
| void | setPerimeter(const QList<QGeoCoordinate> &path) |
Documentation sur les fonctions membres
QGeoPolygon::QGeoPolygon()
Crée un nouveau polygone géométrique vide.
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
Crée un nouveau polygone géographique à partir du contenu de other.
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
Crée un nouveau polygone géographique à partir des coordonnées spécifiées dans ` path`.
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
Crée un nouveau polygone géographique à partir du contenu de other.
[noexcept] QGeoPolygon::~QGeoPolygon()
Supprime ce polygone.
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
Ajoute coordinate au polygone.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
Méthode surchargée. Définit l'holePath e d'un trou situé à l'intérieur du polygone. Le trou est un objet de type « QList » <QGeoCoordinate>.
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
Définit l'holePath pour un trou situé à l'intérieur du polygone. Le trou est un objet de type « QVariant » contenant un « QList » <QGeoCoordinate>.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
Renvoie « true » si le périmètre du polygone contient coordinate parmi ses éléments.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPolygon::coordinateAt(qsizetype index) const
Renvoie la coordonnée à l'adresse index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] const QVariantList QGeoPolygon::hole(qsizetype index) const
Renvoie un objet de type « QVariant » contenant un objet de type « QList » <QGeoCoordinate> qui représente le trou situé à l'adresse index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
Renvoie un objet de type « QList » <QGeoCoordinate> qui représente le trou situé à l'adresse index.
[invokable] qsizetype QGeoPolygon::holesCount() const
Renvoie le nombre de trous.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Insère coordinate à l'adresse spécifiée index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] double QGeoPolygon::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Renvoie la longueur du périmètre du polygone, en mètres, entre l'élément indexFrom et l'élément indexTo. Cette longueur correspond à la somme des distances les plus courtes entre chaque paire de points adjacents.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[since QtPositioning 5.12] const QList<QGeoCoordinate> &QGeoPolygon::perimeter() const
Renvoie tous les éléments du périmètre du polygone.
Remarque : fonctionde lecture de la propriété perimeter.
Cette fonction a été introduite dans QtPositioning 5.12.
Voir aussi setPerimeter().
[invokable] void QGeoPolygon::removeCoordinate(const QGeoCoordinate &coordinate)
Supprime la dernière occurrence de ` coordinate ` du polygone.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::removeCoordinate(qsizetype index)
Supprime de l'élément le point situé à la position index.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::removeHole(qsizetype index)
Supprime l'élément situé à la position index de la liste des trous.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Remplace l'élément « path » à l'index spécifiée par coordinate.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
Définit le périmètre du polygone à partir d'une liste de coordonnées path.
Remarque : fonctionde définition de la propriété perimeter.
Cette fonction a été introduite dans QtPositioning 5.12.
Voir aussi perimeter().
[invokable] qsizetype QGeoPolygon::size() const
Renvoie le nombre d'éléments du polygone.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QString QGeoPolygon::toString() const
Renvoie les propriétés du polygone géographique sous forme de chaîne de caractères.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
Translate ce géo-polygone de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à un décalage vers le sud et vers l'ouest.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce géopolygone décalé de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à un décalage vers le sud et vers l'ouest.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
Voir également translate().
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
Attribue la fonction « other » à ce polygone géographique et renvoie une référence à ce polygone géographique.
© 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.
