MapPolygon QML Type

Le type MapPolygon permet d'afficher un polygone sur une carte. Plus d'informations...

• Liste de tous les membres, y compris les membres hérités
• MapPolygon fait partie de QML Maps Plugin.

Propriétés

• autoFadeIn : bool
• border
  • border.color : color
  • border.width : int
• color : color
• path : list<coordinate>
• referenceSurface : enum (since 6.5)

Méthodes

• void addCoordinate(coordinate)
• void removeCoordinate(coordinate)

Description détaillée

Le type MapPolygon affiche un polygone sur une carte, spécifié en termes de liste ordonnée de coordinates. Pour une meilleure apparence et de meilleurs résultats, les polygones doivent être simples (sans auto-intersection).

Les coordonnées peuvent être ajoutées ou supprimées à tout moment à l'aide des méthodes addCoordinate et removeCoordinate. Elles peuvent également être modifiées comme tout autre élément de liste en QML :

mapPolygon.path[0].latitude = 5;

Pour dessiner des rectangles aux bords "droits" (même latitude sur un bord, même latitude sur l'autre), le type MapRectangle fournit une API plus simple, à deux points.

Par défaut, le polygone est affiché sous la forme d'une bordure noire de 1 pixel sans remplissage. Pour modifier son apparence, utilisez les propriétés color, border.color et border.width.

Exemple d'utilisation

L'extrait suivant montre un MapPolygon utilisé pour afficher un triangle dont les trois sommets sont situés près de Brisbane, en Australie. Le triangle est rempli en vert, avec une bordure noire de 1 pixel.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 }
        ]
    }
}

Documentation sur les propriétés

autoFadeIn : bool

Cette propriété indique si l'élément s'estompe automatiquement lorsque l'on zoome sur la carte à partir d'un niveau de zoom très bas. La valeur par défaut est true. Si vous attribuez la valeur false à cette propriété, l'élément de la carte aura toujours l'opacité spécifiée par la propriété QtQuick::Item::opacity, qui est de 1,0 par défaut.

border group

Cette propriété fait partie du groupe de propriétés "border". Le groupe de propriétés border contient la largeur et la couleur utilisées pour dessiner la bordure du polygone.

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 qu'il n'y ait pas de ligne, utilisez une largeur de 0 ou une couleur transparente.

color : color

Cette propriété contient la couleur utilisée pour remplir le polygone.

La valeur par défaut est transparente.

path : list<coordinate>

Cette propriété contient la liste ordonnée des coordonnées qui définissent le polygone. Le fait d'avoir moins de 3 coordonnées différentes dans le chemin entraîne un comportement non défini.

Voir également addCoordinate et removeCoordinate.

referenceSurface : enum [since 6.5]

Cette propriété détermine la surface de référence du polygone. Si elle vaut QLocation::ReferenceSurface::Map, les sommets du polygone sont reliés par des lignes droites sur la carte. Si la valeur est QLocation::ReferenceSurface::Globe, les sommets sont reliés en suivant la trajectoire du grand cercle, qui décrit la liaison la plus courte entre deux points d'une sphère. La valeur par défaut est QLocation::ReferenceSurface::Map.

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

Documentation de la méthode

void addCoordinate(coordinate)

Ajoute le site coordinate spécifié au chemin d'accès.

Voir également removeCoordinate et path.

void removeCoordinate(coordinate)

Supprime coordinate du chemin. S'il existe plusieurs instances de la même coordonnée, c'est celle qui a été ajoutée en dernier qui est supprimée.

Si coordinate n'est pas dans le chemin, cette méthode ne fait rien.

Voir également addCoordinate et path.