QGeoCircle Class
La classe QGeoCircle définit une zone géographique circulaire. En savoir plus...
| En-tête : | #include <QGeoCircle> |
| 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
| QGeoCircle() | |
| QGeoCircle(const QGeoShape &other) | |
| QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0) | |
| QGeoCircle(const QGeoCircle &other) | |
| ~QGeoCircle() | |
| QGeoCoordinate | center() const |
| void | extendCircle(const QGeoCoordinate &coordinate) |
| qreal | radius() const |
| void | setCenter(const QGeoCoordinate ¢er) |
| void | setRadius(qreal radius) |
| QString | toString() const |
| void | translate(double degreesLatitude, double degreesLongitude) |
| QGeoCircle | translated(double degreesLatitude, double degreesLongitude) const |
| QGeoCircle & | operator=(const QGeoCircle &other) |
Description détaillée
Le cercle est défini par un paramètre de type « QGeoCoordinate » qui spécifie le centre du cercle et un paramètre de type «qreal» qui spécifie le rayon du cercle en mètres.
Le cercle est considéré comme invalide si la coordonnée du centre est invalide ou si le rayon est inférieur à zéro.
Cette classe est également accessible en QML sous le nom geoCircle.
Documentation des propriétés
center : QGeoCoordinate
Cette propriété contient les coordonnées du centre du cercle géographique.
Le cercle est considéré comme non valide si cette propriété contient une coordonnée non valide.
Un objet ` QGeoCircle ` créé par défaut utilise une coordonnée ` QGeoCoordinate ` invalide comme centre.
Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès associées existent depuis la première version de cette classe.
Fonctions d'accès :
radius : qreal
Cette propriété contient le rayon du cercle en mètres.
Le cercle est considéré comme non valide si cette propriété est négative.
Par défaut, le rayon est initialisé à -1.
Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès associées existent depuis la première version de cette classe.
Fonctions d'accès :
Documentation des fonctions membres
QGeoCircle::QGeoCircle()
Crée un nouveau cercle géographique non valide.
QGeoCircle::QGeoCircle(const QGeoShape &other)
Crée un nouveau cercle géométrique à partir du contenu de other.
QGeoCircle::QGeoCircle(const QGeoCoordinate ¢er, qreal radius = -1.0)
Crée un nouveau cercle géométrique centré sur center et d'un rayon de radius mètres.
QGeoCircle::QGeoCircle(const QGeoCircle &other)
Crée un nouveau cercle géométrique à partir du contenu de other.
[noexcept] QGeoCircle::~QGeoCircle()
Supprime ce cercle géométrique.
QGeoCoordinate QGeoCircle::center() const
Renvoie les coordonnées du centre de ce cercle géométrique. Équivalent à ` QGeoShape::center()`.
Remarque : fonctiongetter pour la propriété « center ».
Voir aussi setCenter().
[invokable] void QGeoCircle::extendCircle(const QGeoCoordinate &coordinate)
Étend le cercle géométrique pour inclure également la coordonnée coordinate
Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.
qreal QGeoCircle::radius() const
Renvoie le rayon, en mètres, de ce cercle géométrique.
Remarque : fonctiongetter pour la propriété radius.
Voir aussi setRadius().
void QGeoCircle::setCenter(const QGeoCoordinate ¢er)
Définit la coordonnée centrale de ce cercle géométrique sur center.
Remarque : fonctionde définition de la propriété center.
Voir aussi ` center()`.
void QGeoCircle::setRadius(qreal radius)
Définit le rayon, en mètres, de ce cercle géographique sur radius.
Remarque : fonctionde définition de la propriété radius.
Voir également radius().
[invokable] QString QGeoCircle::toString() const
Renvoie les propriétés du cercle géométrique 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 QGeoCircle::translate(double degreesLatitude, double degreesLongitude)
Translate ce cercle géographique 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] QGeoCircle QGeoCircle::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce cercle 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 à 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().
QGeoCircle &QGeoCircle::operator=(const QGeoCircle &other)
Attribue la fonction « other » à ce cercle géographique et renvoie une référence à ce cercle 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.
