MapPolyline QML Type

Le type MapPolyline affiche une polyligne sur une carte. En savoir plus...

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

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, définie par une liste ordonnée de coordonnées ( coordinates).

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 :

mapPolyline.path[0].latitude = 5;

Par défaut, la polyligne s'affiche sous la forme d'une ligne noire d'un pixel d'épaisseur. Il est possible de modifier cette valeur à l'aide des propriétés ` line.width ` et ` line.color `.

Exemple d'utilisation

L'extrait de code suivant montre une MapPolyline comportant 4 points, formant une forme ressemblant à la partie supérieure d'un « point d'interrogation » (?), près de Brisbane, en Australie. La ligne tracée mesure 3 pixels de large et est de 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é 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.

line group

Cette propriété fait partie du groupe de propriétés « ligne ». Le groupe de propriétés « ligne » contient la largeur et la couleur utilisées pour tracer 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 à un contour noir d'une largeur de 1 pixel.

Pour ne pas afficher 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 elle est définie sur « QLocation::ReferenceSurface::Globe », les sommets sont reliés en suivant le chemin du 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 de la méthode

void addCoordinate(coordinate)

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

Voir également insertCoordinate, removeCoordinate et path.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Renvoie « true » si l'coordinate e indiquée fait partie du chemin d'accès.

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

[since QtLocation 5.6] coordinate coordinateAt(index)

Récupère les coordonnées de la polyligne à l'index e indiquée. Si l' e se trouve en dehors des limites du tracé, une coordonnée non valide est renvoyée.

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

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

Insère un élément « coordinate » dans le chemin d'accès à l'adresse index.

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

Voir également 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 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, insertCoordinate et path.

[since QtLocation 5.6] void removeCoordinate(index)

Supprime une coordonnée du chemin à l'index e indiquée.

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

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

Voir également addCoordinate, insertCoordinate et path.

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

Remplace la coordonnée du tracé actuel à l'index e indiquée par la nouvelle coordinate.

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

Voir également addCoordinate, insertCoordinate, removeCoordinate et path.

void setPath(geoPath path)

Définit l'path e à l'aide d'un type « geoPath ».

Voir également path.