MapPolyline QML Type

Der Typ MapPolyline zeigt eine Polylinie auf einer Karte an. Mehr...

Import Statement:	`import QtLocation 6.8`
Since:	QtLocation 5.0

Liste aller Mitglieder, einschließlich geerbter Mitglieder
MapPolyline ist Teil des QML Maps Plugin.

Eigenschaften

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

Methoden

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)

Detaillierte Beschreibung

Der Typ MapPolyline stellt eine Polylinie auf einer Karte dar, die in Form einer geordneten Liste von coordinates angegeben wird. Die coordinates auf dem Pfad kann nicht direkt geändert werden, nachdem sie zur Polylinie hinzugefügt wurde. Kopieren Sie stattdessen die path in eine var, ändern Sie die Kopie und ordnen Sie die Kopie wieder der path zu.

var path = mapPolyline.path;
path[0].latitude = 5;
mapPolyline.path = path;

Koordinaten können auch jederzeit mit den Methoden addCoordinate und removeCoordinate hinzugefügt und entfernt werden.

Standardmäßig wird die Polylinie als 1 Pixel dicke schwarze Linie angezeigt. Dies kann mit den Eigenschaften line.width und line.color geändert werden.

Beispielverwendung

Der folgende Ausschnitt zeigt eine MapPolyline mit 4 Punkten, die eine Form wie der obere Teil eines "Fragezeichens" (?) in der Nähe von Brisbane, Australien, bildet. Die gezeichnete Linie ist 3 Pixel breit und hat eine grüne Farbe.

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 }
        ]
    }
}

Eigenschaft Dokumentation

autoFadeIn : bool

Diese Eigenschaft legt fest, ob das Element automatisch eingeblendet wird, wenn von sehr niedrigen Zoomstufen aus in die Karte gezoomt wird. Standardmäßig ist dies true. Wenn Sie diese Eigenschaft auf false setzen, hat das Kartenelement immer die mit der Eigenschaft QtQuick::Item::opacity festgelegte Deckkraft, die standardmäßig 1,0 beträgt.

line group
line.color : color
line.width : int

Diese Eigenschaft ist Teil der Eigenschaftsgruppe Linie. Die Eigenschaftsgruppe Linie enthält die Breite und die Farbe, die zum Zeichnen der Linie verwendet werden.

Die Breite wird in Pixeln angegeben und ist unabhängig von der Zoomstufe der Karte. Die Standardwerte entsprechen einem schwarzen Rand mit einer Breite von 1 Pixel.

Wenn Sie keine Linie wünschen, verwenden Sie eine Breite von 0 oder eine transparente Farbe.

path : list<coordinate>

Diese Eigenschaft enthält die geordnete Liste der Koordinaten, die die Polylinie definieren.

referenceSurface : enum [since 6.5]

Diese Eigenschaft bestimmt die Bezugsfläche des Linienzugs. Wenn sie auf QLocation::ReferenceSurface::Map gesetzt ist, werden die Eckpunkte der Polylinie mit geraden Linien auf der Karte verbunden. Wenn sie auf QLocation::ReferenceSurface::Globe gesetzt ist, werden die Scheitelpunkte auf dem Großkreisweg verbunden, der die kürzeste Verbindung zwischen zwei Punkten auf einer Kugel beschreibt. Der Standardwert ist QLocation::ReferenceSurface::Map.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

Methode Dokumentation

void addCoordinate(coordinate)

Fügt die angegebene coordinate am Ende des Pfades hinzu.

Siehe auch insertCoordinate, removeCoordinate, und path.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Gibt true zurück, wenn die angegebene coordinate Teil des Pfades ist.

Diese Methode wurde in QtLocation 5.6 eingeführt.

[since QtLocation 5.6] coordinate coordinateAt(index)

Ermittelt die Koordinate der Polylinie an der angegebenen index. Wenn der Index außerhalb der Pfadgrenzen liegt, wird eine ungültige Koordinate zurückgegeben.

Diese Methode wurde in QtLocation 5.6 eingeführt.

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

Fügt eine coordinate in den Pfad an der angegebenen index ein.

Diese Methode wurde in QtLocation 5.6 eingeführt.

Siehe auch addCoordinate, removeCoordinate, und path.

[since QtLocation 5.6] int pathLength()

Gibt die Anzahl der Koordinaten der Polylinie zurück.

Diese Methode wurde in QtLocation 5.6 eingeführt.

Siehe auch path.

void removeCoordinate(coordinate)

Entfernt coordinate aus dem Pfad. Wenn es mehrere Instanzen der gleichen Koordinate gibt, wird die zuletzt hinzugefügte entfernt.

Wenn coordinate nicht im Pfad enthalten ist, bewirkt diese Methode nichts.

Siehe auch addCoordinate, insertCoordinate, und path.

[since QtLocation 5.6] void removeCoordinate(index)

Entfernt eine Koordinate aus dem Pfad an der angegebenen index.

Wenn index ungültig ist, führt diese Methode nichts aus.

Diese Methode wurde in QtLocation 5.6 eingeführt.

Siehe auch addCoordinate, insertCoordinate, und path.

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

Ersetzt die Koordinate im aktuellen Pfad an der angegebenen index durch die neue coordinate.

Diese Methode wurde in QtLocation 5.6 eingeführt.

Siehe auch addCoordinate, insertCoordinate, removeCoordinate, und path.

void setPath(geopath path)

Setzt die path unter Verwendung eines Geopath-Typs.

Siehe auch path.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.