Sur cette page

geoCircle QML Value Type

Le type « geoCircle » représente une zone géographique circulaire. En savoir plus…

Import Statement: import QtPositioning

Propriétés

Description détaillée

Le type geoCircle est un objet de type « geoShape » qui représente une zone géographique circulaire. Il s'agit d'une représentation directe d'un « QGeoCircle » et est défini par un « coordinate » qui spécifie l'center du cercle et un « qreal » qui spécifie l'radius du cercle en mètres.

Le cercle est considéré comme non valide si la coordonnée « center » est incorrecte ou si la « radius » est inférieure à zéro.

Exemple d’utilisation

Pour créer une valeur geoCircle, utilisez la fonction QtPositioning.circle() :

import QtPositioning

Item {
    property geoCircle region: QtPositioning.circle(QtPositioning.coordinate(-27.5, 153.1), 1000)
}

Lors de l’intégration avec C++, toute valeur QGeoCircle transmise à QML depuis C++ est automatiquement convertie en valeur geoCircle. De même, les valeurs geoCircle sont converties en valeurs QGeoCircle lorsqu’elles sont transmises de QML vers C++.

Documentation sur les propriétés

center : geoCoordinate

Cette propriété contient les coordonnées du centre de l'geoCircle.

radius : real

Cette propriété indique le rayon de l'geoCircle, en mètres.

La valeur par défaut du rayon est -1, ce qui indique une zone d'geoCircle non valide.

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