MapPolyline QML Type

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

• Liste aller Mitglieder, einschließlich geerbter Mitglieder
• „MapPolyline“ ist Teil des QML-Maps-Plugins.

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)

Ausführliche Beschreibung

Der Typ „MapPolyline“ zeigt eine Polylinie auf einer Karte an, die durch eine geordnete Liste von „ coordinates “-Objekten definiert ist.

Koordinaten können jederzeit mithilfe der Methoden „ addCoordinate “ und „ removeCoordinate “ hinzugefügt oder entfernt werden. Sie können außerdem wie jedes andere Listenelement in QML geändert werden:

mapPolyline.path[0].latitude = 5;

Standardmäßig wird die Polylinie als 1 Pixel dicke schwarze Linie dargestellt. Dies lässt sich mithilfe der Eigenschaften „ line.width “ und „ line.color “ ändern.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt eine `MapPolyline` mit 4 Punkten, die eine Form bildet, die dem oberen Teil eines „Fragezeichens“ (?) ähnelt, in der Nähe von Brisbane, Australien. Die gezeichnete Linie ist 3 Pixel breit und grün.

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

Dokumentation zu den Eigenschaften

autoFadeIn : bool

Diese Eigenschaft legt fest, ob das Element automatisch eingeblendet wird, wenn die Karte ausgehend von sehr niedrigen Zoomstufen vergrößert wird. Standardmäßig ist hier „ true “ eingestellt. Wird diese Eigenschaft auf „ false “ gesetzt, wird das Kartenelement stets mit der durch die Eigenschaft „ QtQuick::Item::opacity “ festgelegten Deckkraft angezeigt, die standardmäßig 1,0 beträgt.

line group

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 vom Zoom-Level der Karte. Die Standardwerte entsprechen einem schwarzen Rand mit einer Breite von 1 Pixel.

Wenn keine Linie angezeigt werden soll, 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 legt die Referenzfläche der Polylinie fest. Wenn sie auf „ QLocation::ReferenceSurface::Map “ gesetzt ist, werden die Eckpunkte der Polylinie auf der Karte durch gerade Linien verbunden. Wenn sie auf „ QLocation::ReferenceSurface::Globe “ gesetzt ist, werden die Eckpunkte entlang der Großkreislinie verbunden, die 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.

Methodendokumentation

void addCoordinate(coordinate)

Fügt die angegebene „ coordinate “ an das Ende des Pfads an.

Siehe auch „ insertCoordinate “, „ removeCoordinate “ und „ path “.

[since QtLocation 5.6] coordinate containsCoordinate(coordinate)

Gibt „true“ zurück, wenn die angegebene „ coordinate “ Teil des Pfads ist.

Diese Methode wurde in QtLocation 5.6 eingeführt.

[since QtLocation 5.6] coordinate coordinateAt(index)

Ruft die Koordinate der Polylinie an der angegebenen Position „ index “ ab. Liegt der Index außerhalb der Grenzen des Pfades, 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 einen „ coordinate “ an die Stelle im Pfad ein, die durch die angegebene „ index “ angegeben ist.

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 mehrere Einträge mit derselben Koordinate vorhanden sind, wird der zuletzt hinzugefügte entfernt.

Befindet sich „ coordinate “ nicht im Pfad, führt diese Methode keine Aktion aus.

Siehe auch „ addCoordinate “, „ insertCoordinate “ und „ path “.

[since QtLocation 5.6] void removeCoordinate(index)

Entfernt eine Koordinate aus dem Pfad an der angegebenen Stelle „ index “.

Ist ` index ` ungültig, führt diese Methode keine Aktion 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 Position „ index “ durch die neue Position „ coordinate “.

Diese Methode wurde in QtLocation 5.6 eingeführt.

Siehe auch „ addCoordinate“ , „ insertCoordinate “, „ removeCoordinate “ und „ path “.

void setPath(geoPath path)

Legt die „ path “ mithilfe eines „ geoPath “-Typs fest.

Siehe auch „ path “.