MapPolygon QML Type

Der Typ „MapPolygon“ zeigt ein Polygon auf einer Karte an. Mehr...

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

Eigenschaften

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

Methoden

• void addCoordinate(coordinate)
• void removeCoordinate(coordinate)

Ausführliche Beschreibung

Der Typ „MapPolygon“ zeigt ein Polygon auf einer Karte an, das durch eine geordnete Liste von „ coordinates “ definiert ist. Für eine optimale Darstellung und beste Ergebnisse sollten Polygone einfach sein (keine Selbstschnittstellen aufweisen).

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

mapPolygon.path[0].latitude = 5;

Zum Zeichnen von Rechtecken mit „geraden“ Kanten (gleiche Breite entlang einer Kante, gleiche Breite entlang der anderen) bietet der Typ „ MapRectangle “ eine einfachere Zwei-Punkt-API.

Standardmäßig wird das Polygon als schwarzer 1-Pixel-Rahmen ohne Füllung dargestellt. Um sein Aussehen zu ändern, verwenden Sie die Eigenschaften „ color “, „ border.color “ und „ border.width “.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt die Verwendung eines „MapPolygon“ zur Darstellung eines Dreiecks mit drei Eckpunkten in der Nähe von Brisbane, Australien. Das Dreieck ist grün ausgefüllt und hat einen 1-Pixel-breiten schwarzen Rand.

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

Dokumentation der 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 diese Eigenschaft auf „ true “ gesetzt. Wenn diese Eigenschaft auf „ false “ gesetzt wird, wird für das Kartenelement stets die mit der Eigenschaft „ QtQuick::Item::opacity “ festgelegte Deckkraft verwendet, die standardmäßig 1,0 beträgt.

border group

Diese Eigenschaft gehört zur Eigenschaftsgruppe „Border“. Die Eigenschaftsgruppe „Border“ enthält die Breite und die Farbe, die zum Zeichnen des Umrisses des Polygons verwendet werden.

Die Breite wird in Pixeln angegeben und ist unabhängig vom Zoomfaktor der Karte.

Die Standardwerte entsprechen einem schwarzen Rahmen mit einer Breite von 1 Pixel. Um keinen Rahmen anzuzeigen, verwenden Sie eine Breite von 0 oder eine transparente Farbe.

color : color

Diese Eigenschaft gibt die Farbe an, mit der das Polygon ausgefüllt wird.

Der Standardwert ist „transparent“.

path : list<coordinate>

Diese Eigenschaft enthält die geordnete Liste der Koordinaten, die das Polygon definieren. Wenn der Pfad weniger als drei verschiedene Koordinaten enthält, führt dies zu undefiniertem Verhalten.

Siehe auch addCoordinate und removeCoordinate.

referenceSurface : enum [since 6.5]

Diese Eigenschaft legt die Referenzfläche des Polygons fest. Ist sie auf „ QLocation::ReferenceSurface::Map “ gesetzt, werden die Eckpunkte des Polygons auf der Karte durch gerade Linien verbunden. Ist sie auf „ QLocation::ReferenceSurface::Globe “ gesetzt, 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 zum Pfad hinzu.

Siehe auch „ removeCoordinate “ und „ 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 “ und „ path “.