Sur cette page

QGeoCircle Class

La classe QGeoCircle définit une zone géographique circulaire. Plus d'informations...

En-tête : #include <QGeoCircle>
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

QGeoCircle()
QGeoCircle(const QGeoShape &other)
QGeoCircle(const QGeoCoordinate &center, qreal radius = -1.0)
QGeoCircle(const QGeoCircle &other)
~QGeoCircle()
QGeoCoordinate center() const
void extendCircle(const QGeoCoordinate &coordinate)
qreal radius() const
void setCenter(const QGeoCoordinate &center)
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 en termes de QGeoCoordinate qui spécifie le centre du cercle et de 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 la forme geoCircle.

Documentation sur les propriétés

center : QGeoCoordinate

Cette propriété contient la coordonnée du centre du cercle géographique.

Le cercle est considéré comme non valide si cette propriété contient une coordonnée non valide.

Une construction par défaut QGeoCircle utilise un QGeoCoordinate invalide comme centre.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès correspondantes existent depuis la première version de cette classe.

Fonctions d'accès :

QGeoCoordinate center() const
void setCenter(const QGeoCoordinate &center)

radius : qreal

Cette propriété indique le rayon du cercle en mètres.

Le cercle est considéré comme invalide si cette propriété est négative.

Par défaut, le rayon est initialisé avec -1.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès correspondantes existent depuis la première version de cette classe.

Fonctions d'accès :

qreal radius() const
void setRadius(qreal radius)

Documentation des fonctions membres

QGeoCircle::QGeoCircle()

Construit un nouveau cercle géographique non valide.

QGeoCircle::QGeoCircle(const QGeoShape &other)

Construit un nouveau cercle géographique à partir du contenu de other.

QGeoCircle::QGeoCircle(const QGeoCoordinate &center, qreal radius = -1.0)

Construit un nouveau cercle géographique centré sur center et d'un rayon de radius mètres.

QGeoCircle::QGeoCircle(const QGeoCircle &other)

Construit un nouveau cercle géographique à partir du contenu de other.

[noexcept] QGeoCircle::~QGeoCircle()

Détruit ce cercle géographique.

QGeoCoordinate QGeoCircle::center() const

Renvoie les coordonnées du centre de ce géocercle. Équivalent à QGeoShape::center().

Remarque : fonction Getter pour la propriété center.

Voir aussi setCenter().

[invokable] void QGeoCircle::extendCircle(const QGeoCoordinate &coordinate)

Étend le cercle géographique pour couvrir également la coordonnée. coordinate

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

qreal QGeoCircle::radius() const

Renvoie le rayon en mètres de ce cercle géographique.

Note : Fonction Getter pour la propriété radius.

Voir également setRadius().

void QGeoCircle::setCenter(const QGeoCoordinate &center)

Fixe la coordonnée centrale de ce cercle géographique à center.

Remarque : fonction de définition de la propriété center.

Voir également center().

void QGeoCircle::setRadius(qreal radius)

Fixe le rayon en mètres de ce cercle géographique à radius.

Remarque : fonction de définition de la propriété radius.

Voir également radius().

[invokable] QString QGeoCircle::toString() const

Renvoie les propriétés du cercle 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 QGeoCircle::translate(double degreesLatitude, double degreesLongitude)

Traduit ce cercle 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] QGeoCircle QGeoCircle::translated(double degreesLatitude, double degreesLongitude) const

Renvoie une copie de ce cercle 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().

QGeoCircle &QGeoCircle::operator=(const QGeoCircle &other)

Attribue 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.