QGeoPath Class
La classe QGeoPath définit un chemin géographique. En savoir plus...
| En-tête : | #include <QGeoPath> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
| Hérite de : | QGeoShape |
Propriétés
Fonctions publiques
| QGeoPath() | |
| QGeoPath(const QGeoShape &other) | |
| QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0) | |
| QGeoPath(const QGeoPath &other) | |
| ~QGeoPath() | |
| void | addCoordinate(const QGeoCoordinate &coordinate) |
| void | clearPath() |
| bool | containsCoordinate(const QGeoCoordinate &coordinate) const |
| QGeoCoordinate | coordinateAt(qsizetype index) const |
| void | insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| double | length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const |
| const QList<QGeoCoordinate> & | path() const |
| void | removeCoordinate(const QGeoCoordinate &coordinate) |
| void | removeCoordinate(qsizetype index) |
| void | replaceCoordinate(qsizetype index, const QGeoCoordinate &coordinate) |
| void | setPath(const QList<QGeoCoordinate> &path) |
| void | setWidth(const qreal &width) |
| qsizetype | size() const |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoPath | translated(double degreesLatitude, double degreesLongitude) const |
| qreal | width() const |
| QGeoPath & | operator=(const QGeoPath &other) |
Description détaillée
Le tracé est défini par une liste ordonnée d’objets « QGeoCoordinate ».
Deux éléments adjacents du chemin sont censés être reliés par le segment de droite le plus court, de cap constant, passant par ces 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 pertinent pour le calcul du rectangle englobant renvoyé par la méthode 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 du chemin. De même, la latitude du coin inférieur droit correspondra à la latitude minimale de l’ensemble des points du chemin.
Cette classe est également accessible en QML sous le nom geoPath.
Un QGeoPath est à la fois invalide et vide s’il ne contient aucune coordonnée.
Remarque : un QGeoPath créé par défaut est à la fois invalide et vide, car il ne contient aucune coordonnée.
Documentation des propriétés
path : QVariantList
Cette propriété contient la liste des coordonnées du chemin géographique.
Remarque : les coordonnées ne peuvent pas être traitées sur place. Pour modifier la valeur de cette propriété, récupérez la liste complète des coordonnées, traitez-les, puis attribuez la nouvelle valeur à la propriété.
width : qreal
Cette propriété indique la largeur du chemin en mètres.
Fonctions d'accès :
| qreal | width() const |
| void | setWidth(const qreal &width) |
Documentation sur les fonctions membres
QGeoPath::QGeoPath()
Crée un nouveau chemin géographique vide.
QGeoPath::QGeoPath(const QGeoShape &other)
Crée un nouveau chemin géographique à partir du contenu de other.
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
Crée un nouveau chemin géographique à partir d'une liste de coordonnées (path et width).
QGeoPath::QGeoPath(const QGeoPath &other)
Crée un nouveau chemin géographique à partir du contenu de other.
[noexcept] QGeoPath::~QGeoPath()
Supprime ce chemin.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Ajoute coordinate au chemin d'accès.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
void QGeoPath::clearPath()
Cela ouvre la voie.
[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const
Renvoie « true » si le chemin 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 QGeoPath::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] void QGeoPath::insertCoordinate(qsizetype index, const QGeoCoordinate &coordinate)
Insère coordinate à l'index spécifiée.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] double QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Renvoie la longueur du chemin, 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.
Si indexTo vaut -1 (valeur par défaut), la longueur inclura la distance entre la dernière coordonnée et la première (boucle fermée). Pour récupérer la longueur du chemin, utilisez 0 pour indexFrom et QGeoPath::size() - 1 pour indexTo.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
const QList<QGeoCoordinate> &QGeoPath::path() const
Renvoie tous les éléments du chemin.
Voir aussi setPath().
[invokable] void QGeoPath::removeCoordinate(const QGeoCoordinate &coordinate)
Supprime la dernière occurrence de ` coordinate ` du chemin.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
Supprime de l'élément de chemin 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 QGeoPath::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.
void QGeoPath::setPath(const QList<QGeoCoordinate> &path)
Définit tous les éléments de l'path.
Voir aussi path().
[invokable] qsizetype QGeoPath::size() const
Renvoie le nombre d'éléments du chemin.
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
[invokable] QString QGeoPath::toString() const
Renvoie les propriétés du chemin 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 QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Translate ce chemin géographique de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation 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] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce chemin géographique décalé de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation 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().
qreal QGeoPath::width() const
Renvoie la largeur du chemin, en mètres. Cette information est utilisée dans la méthode ` contains `. La valeur par défaut est 0.
Remarque : fonctiongetter pour la propriété width.
Voir aussi setWidth().
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
Attribue la valeur « other » à ce chemin géographique et renvoie une référence à ce chemin 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.
