QGeoPath Class
La classe QGeoPath définit un chemin géographique. Plus d'informations...
| En-tête : | #include <QGeoPath> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
| Héritages : | 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 chemin est défini par une liste ordonnée d'objets QGeoCoordinate.
Tous les deux éléments adjacents du chemin 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 base 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 la 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 à l'adresse geoPath.
Un QGeoPath est à la fois invalide et vide s'il ne contient aucune coordonnée.
Note : Un QGeoPath construit par défaut est à la fois invalide et vide car il ne contient aucune coordonnée.
Documentation sur les 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é, il faut récupérer la liste complète des coordonnées, les traiter et attribuer 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 des fonctions membres
QGeoPath::QGeoPath()
Construit un nouveau chemin géographique vide.
QGeoPath::QGeoPath(const QGeoShape &other)
Construit un nouveau chemin géographique à partir du contenu de other.
QGeoPath::QGeoPath(const QList<QGeoCoordinate> &path, const qreal &width = 0.0)
Construit un nouveau chemin géographique à partir d'une liste de coordonnées (path et width).
QGeoPath::QGeoPath(const QGeoPath &other)
Construit un nouveau chemin géographique à partir du contenu de other.
[noexcept] QGeoPath::~QGeoPath()
Détruit ce chemin.
[invokable] void QGeoPath::addCoordinate(const QGeoCoordinate &coordinate)
Ajoute coordinate au chemin.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QGeoPath::clearPath()
Efface le chemin.
[invokable] bool QGeoPath::containsCoordinate(const QGeoCoordinate &coordinate) const
Retourne vrai si le chemin 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 QGeoPath::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] void QGeoPath::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 QGeoPath::length(qsizetype indexFrom = 0, qsizetype indexTo = -1) const
Renvoie la longueur du chemin, 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.
Si indexTo vaut -1 (valeur par défaut), la longueur comprendra la distance entre la dernière coordonnée et la première (boucle fermée). Pour obtenir la longueur du chemin, utilisez 0 pour indexFrom et QGeoPath::size() - 1 pour indexTo.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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.
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] void QGeoPath::removeCoordinate(qsizetype index)
Supprime du chemin 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 QGeoPath::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.
void QGeoPath::setPath(const QList<QGeoCoordinate> &path)
Définit tous les éléments de path.
Voir aussi path().
[invokable] qsizetype QGeoPath::size() const
Renvoie le nombre d'éléments dans le chemin.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QString QGeoPath::toString() const
Renvoie les propriétés du chemin 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 QGeoPath::translate(double degreesLatitude, double degreesLongitude)
Traduit ce chemin géographique 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] QGeoPath QGeoPath::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce chemin géographique traduit 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().
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 : fonction Getter pour la propriété width.
Voir aussi setWidth().
QGeoPath &QGeoPath::operator=(const QGeoPath &other)
Attribue 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.
