MapCircle QML Type

Le type MapCircle affiche un cercle géographique sur une carte. En savoir plus…

• Liste de tous les membres, y compris les membres hérités
• MapCircle fait partie du plugin QML Maps.

Propriétés

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• center : coordinate
• color : color
• opacity : real
• radius : real
• referenceSurface : enum (since 6.5)

Description détaillée

Le type MapCircle affiche un cercle géographique sur une carte, constitué de tous les points situés à une distance donnée d'un point central. En fonction de la projection cartographique, un cercle géographique n'apparaît pas toujours comme un cercle parfait à l'écran : par exemple, dans la projection de Mercator, les cercles prennent une forme ovoïde à mesure qu'ils se rapprochent des pôles. Pour afficher un cercle parfait à l'écran autour d'un point, utilisez plutôt un objet « MapQuickItem » contenant un objet de type « Qt Quick ».

Par défaut, le cercle s’affiche sous la forme d’un contour noir de 1 pixel sans remplissage. Pour modifier son apparence, utilisez les propriétés ` color`, ` border.color ` et ` border.width `.

En interne, un `MapCircle` est implémenté sous la forme d’un polygone à plusieurs côtés. Pour calculer les points de rayon, il utilise un modèle sphérique de la Terre, similaire à la méthode `atDistanceAndAzimuth` de ` geoCoordinate`. Ces deux éléments peuvent parfois avoir des implications sur la précision de la forme du cercle, en fonction de la position et de la projection cartographique.

Exemple d'utilisation

L'extrait de code suivant montre une carte contenant un MapCircle, centré aux coordonnées (-27, 153) et d'un rayon de 5 km. Le cercle est rempli en vert, avec une bordure noire de 3 pixels.

Map {
    MapCircle {
        center {
            latitude: -27.5
            longitude: 153.0
        }
        radius: 5000.0
        color: 'green'
        border.width: 3
    }
}

Documentation des propriétés

autoFadeIn : bool

Cette propriété détermine si l'élément apparaît progressivement lorsque l'on effectue un zoom avant sur la carte à partir de niveaux de zoom très faibles. Par défaut, la valeur est « true ». Si vous définissez cette propriété sur « false », l'élément de la carte aura toujours l'opacité spécifiée par la propriété « QtQuick::Item::opacity », dont la valeur par défaut est 1,0.

border group

Cette propriété fait partie de la propriété groupée « border ». La propriété « border » définit la largeur et la couleur utilisées pour tracer le contour du cercle. La largeur est exprimée en pixels et est indépendante du niveau de zoom de la carte.

Les valeurs par défaut correspondent à une bordure noire d'une largeur de 1 pixel. Pour ne pas afficher de ligne, utilisez une largeur de 0 ou une couleur transparente.

center : coordinate

Cette propriété désigne le point central autour duquel le cercle est défini.

Voir également radius.

color : color

Cette propriété définit la couleur de remplissage du cercle lors de son tracé. Pour ne pas appliquer de remplissage, utilisez une couleur transparente.

opacity : real

Cette propriété définit l'opacité de l'élément. L'opacité est exprimée sous la forme d'un nombre compris entre 0 (entièrement transparent) et 1 (entièrement opaque). La valeur par défaut est 1.

Un élément dont l'opacité est égale à 0 continuera de recevoir les événements de souris. Pour désactiver ces événements, définissez la propriété « visible » de l'élément sur « false ».

radius : real

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

Voir également center.

referenceSurface : enum [since 6.5]

Cette propriété détermine la surface de référence du cercle. Si elle est définie sur « QLocation::ReferenceSurface::Map », le cercle est tracé sous forme de cercle sur la carte, avec une approximation de l’ radius e pour correspondre à l’échelle de la carte au centre du cercle. Si elle est définie sur « QLocation::ReferenceSurface::Globe », le cercle est projeté sur une sphère et le chemin du grand cercle est utilisé pour déterminer la couverture du cercle. La valeur par défaut est « QLocation::ReferenceSurface::Map ».

Cette propriété a été introduite dans Qt 6.5.