MapPolyline QML Type

Le type MapPolyline permet d'afficher une polyligne sur une carte. Plus d'informations...

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

Propriétés

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

Méthodes

• void addCoordinate(coordinate)
• coordinate containsCoordinate(coordinate) (since QtLocation 5.6)
• coordinate coordinateAt(index) (since QtLocation 5.6)
• void insertCoordinate(index, coordinate) (since QtLocation 5.6)
• int pathLength() (since QtLocation 5.6)
• void removeCoordinate(coordinate)
• void removeCoordinate(index) (since QtLocation 5.6)
• void replaceCoordinate(index, coordinate) (since QtLocation 5.6)
• void setPath(geoPath path)

Description détaillée

Le type MapPolyline affiche une polyligne sur une carte, spécifiée en termes de liste ordonnée de coordonnées.

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 :

mapPolyline.path[0].latitude = 5;

Par défaut, la polyligne est affichée sous la forme d'une ligne noire de 1 pixel d'épaisseur. Ceci peut être modifié à l'aide des propriétés line.width et line.color.

Exemple d'utilisation

L'extrait suivant montre une MapPolyline avec 4 points, formant une forme comme la partie supérieure d'un "point d'interrogation" ( ?), près de Brisbane, en Australie. La ligne dessinée a une largeur de 3 pixels et une couleur verte.

Map {
    MapPolyline {
        line.width: 3
        line.color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, longitude: 153.5 },
            { latitude: -29, 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.

line group

Cette propriété fait partie du groupe de propriétés line. Le groupe de propriétés line contient la largeur et la couleur utilisées pour dessiner la ligne.

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 avoir de ligne, utilisez une largeur de 0 ou une couleur transparente.

path : list<coordinate>

Cette propriété contient la liste ordonnée des coordonnées qui définissent la polyligne.

referenceSurface : enum [since 6.5]

Cette propriété détermine la surface de référence de la polyligne. Si elle est définie sur QLocation::ReferenceSurface::Map, les sommets de la polyligne 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 connexion 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 de la méthode

void addCoordinate(coordinate)

Ajoute le site coordinate spécifié à la fin du chemin d'accès.

Voir aussi insertCoordinate, removeCoordinate, et path.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Retourne vrai si le site coordinate fait partie du chemin.

Cette méthode a été introduite dans QtLocation 5.6.

[since QtLocation 5.6] coordinate coordinateAt(index)

Obtient les coordonnées de la polyligne à l'adresse index. Si l'index est en dehors des limites du chemin, une coordonnée invalide est renvoyée.

Cette méthode a été introduite dans QtLocation 5.6.

[since QtLocation 5.6] void insertCoordinate(index, coordinate)

Insère un coordinate sur le chemin au niveau du index donné.

Cette méthode a été introduite dans QtLocation 5.6.

Voir aussi addCoordinate, removeCoordinate, et path.

[since QtLocation 5.6] int pathLength()

Renvoie le nombre de coordonnées de la polyligne.

Cette méthode a été introduite dans QtLocation 5.6.

Voir aussi 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 aussi addCoordinate, insertCoordinate, et path.

[since QtLocation 5.6] void removeCoordinate(index)

Supprime une coordonnée de la trajectoire à l'adresse index.

Si index n'est pas valide, cette méthode ne fait rien.

Cette méthode a été introduite dans QtLocation 5.6.

Voir aussi addCoordinate, insertCoordinate, et path.

[since QtLocation 5.6] void replaceCoordinate(index, coordinate)

Remplace la coordonnée de la trajectoire actuelle à l'adresse index par la nouvelle coordinate.

Cette méthode a été introduite dans QtLocation 5.6.

Voir aussi addCoordinate, insertCoordinate, removeCoordinate, et path.

void setPath(geoPath path)

Définit l'adresse path à l'aide d'un type geoPath.

Voir aussi path.