QGeoPolygon Class
La classe QGeoPolygon définit un polygone géographique. Plus d'informations...
| En-tête : | #include <QGeoPolygon> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
| Héritages : | 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.
Tous les deux éléments adjacents de cette liste sont censés être reliés entre eux par le segment de ligne le plus court de direction constante passant par les deux éléments. Ce type de connexion peut traverser la ligne de changement de date dans le sens longitudinal, mais ne traverse jamais les pôles.
Ceci est important pour le calcul de la boîte de délimitation renvoyée par QGeoShape::boundingGeoRectangle() pour cette forme, dont la latitude du coin supérieur gauche sera fixée à la latitude maximale de l'ensemble des points de trajectoire. De même, la latitude du coin inférieur droit correspondra à la latitude minimale de l'ensemble des points de trajectoire.
Cette classe est également accessible en QML sous la forme geoPolygon.
Documentation sur les 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 des fonctions membres
QGeoPolygon::QGeoPolygon()
Construit un nouveau géopolygone vide.
QGeoPolygon::QGeoPolygon(const QGeoShape &other)
Construit un nouveau géopolygone à partir du contenu de other.
QGeoPolygon::QGeoPolygon(const QList<QGeoCoordinate> &path)
Construit un nouveau géopolygone à partir des coordonnées spécifiées dans path.
QGeoPolygon::QGeoPolygon(const QGeoPolygon &other)
Construit un nouveau géopolygone à partir du contenu de other.
[noexcept] QGeoPolygon::~QGeoPolygon()
Détruit ce polygone.
[invokable] void QGeoPolygon::addCoordinate(const QGeoCoordinate &coordinate)
Ajoute coordinate au polygone.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QGeoPolygon::addHole(const QList<QGeoCoordinate> &holePath)
Méthode surchargée. Définit l'adresse holePath pour un trou à l'intérieur du polygone. Le trou est un QList<QGeoCoordinate>.
[invokable] void QGeoPolygon::addHole(const QVariant &holePath)
Définit le holePath pour un trou à l'intérieur du polygone. Le trou est un QVariant contenant un QList<QGeoCoordinate>.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] bool QGeoPolygon::containsCoordinate(const QGeoCoordinate &coordinate) const
Retourne true si le périmètre du polygone contient coordinate comme l'un des éléments.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QGeoCoordinate QGeoPolygon::coordinateAt(qsizetype index) const
Renvoie la coordonnée à index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] const QVariantList QGeoPolygon::hole(qsizetype index) const
Renvoie un QVariant contenant un QList<QGeoCoordinate> qui représente le trou à index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
const QList<QGeoCoordinate> QGeoPolygon::holePath(qsizetype index) const
Retourne un QList<QGeoCoordinate> qui représente le trou à index.
[invokable] qsizetype QGeoPolygon::holesCount() const
Renvoie le nombre de trous.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Insère coordinate à l'endroit spécifié index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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, de l'élément indexFrom à l'élément indexTo. La longueur est censée être la somme des distances les plus courtes pour chaque paire de points adjacents.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
Note : Fonction Getter pour 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 dans le polygone.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::removeCoordinate(qsizetype index)
Supprime du polygone l'élément situé à la position index.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::removeHole(qsizetype index)
Supprime de la liste des trous l'élément situé à la position index.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Remplace l'élément de chemin à l'endroit spécifié index par coordinate.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[since QtPositioning 5.12] void QGeoPolygon::setPerimeter(const QList<QGeoCoordinate> &path)
Définit le périmètre du polygone sur la base d'une liste de coordonnées path.
Note : Fonction de définition de la propriété perimeter.
Cette fonction a été introduite dans QtPositioning 5.12.
Voir également perimeter().
[invokable] qsizetype QGeoPolygon::size() const
Renvoie le nombre d'éléments du polygone.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QString QGeoPolygon::toString() const
Renvoie les propriétés du polygone géographique sous la forme d'une chaîne de caractères.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPolygon::translate(double degreesLatitude, double degreesLongitude)
Traduit ce géopolygone de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Les valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation vers le sud et vers l'ouest.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QGeoPolygon QGeoPolygon::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce géopolygone traduite par degreesLatitude vers le nord et degreesLongitude vers l'est.
Les valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation vers le sud et vers l'ouest.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également translate().
QGeoPolygon &QGeoPolygon::operator=(const QGeoPolygon &other)
Attribue other à ce géopolygone et renvoie une référence à ce géopolygone.
© 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.
