MapPolygon QML Type

Le type MapPolygon affiche un polygone sur une carte. En savoir plus...

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

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, défini par une liste ordonnée de coordonnées coordinates. Pour un rendu et des résultats optimaux, les polygones doivent être simples (sans intersection interne).

Des 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 n’importe quel autre élément de liste en QML :

mapPolygon.path[0].latitude = 5;

Pour dessiner des rectangles aux bords « droits » (même latitude d’un côté, même latitude de l’autre), le type ` MapRectangle ` fournit une API à deux points plus simple.

Par défaut, le polygone 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 `.

Exemple d’utilisation

L'extrait de code suivant montre l'utilisation d'un MapPolygon pour afficher un triangle dont les trois sommets se situent près de Brisbane, en Australie. Le triangle est rempli de vert et bordé d'un contour noir d'un pixel.

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

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 », 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 tracer le contour 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 ne pas afficher de ligne, utilisez une largeur de 0 ou une couleur transparente.

color : color

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

La valeur par défaut est « transparent ».

path : list<coordinate>

Cette propriété contient la liste ordonnée des coordonnées qui définissent le polygone. Si le tracé comporte moins de 3 coordonnées différentes, cela entraîne un comportement indé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 est définie sur « QLocation::ReferenceSurface::Map », les sommets du polygone sont reliés par des lignes droites sur la carte. Si elle est définie sur « QLocation::ReferenceSurface::Globe », les sommets sont reliés en suivant la trajectoire de l'arc de grand cercle, qui décrit la liaison la plus courte entre deux points sur une sphère. La valeur par défaut est « QLocation::ReferenceSurface::Map ».

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

Documentation des méthodes

void addCoordinate(coordinate)

Ajoute l'coordinate spécifiée au chemin d'accès.

Voir également removeCoordinate et path.

void removeCoordinate(coordinate)

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

Si coordinate ne figure pas dans le chemin, cette méthode ne fait rien.

Voir également addCoordinate et path.