MapPolygon QML Type

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

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

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

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)

Detaillierte Beschreibung

Der Typ MapPolygon stellt ein Polygon auf einer Karte dar, das durch eine geordnete Liste von coordinates spezifiziert wird. Für ein optimales Erscheinungsbild und beste Ergebnisse sollten Polygone einfach sein (sich nicht selbst überschneiden).

Die coordinates auf dem Pfad kann nicht direkt geändert werden, nachdem sie dem Polygon 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 = mapPolygon.path;
path[0].latitude = 5;
mapPolygon.path = path;

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

Zum Zeichnen von Rechtecken mit "geraden" Kanten (gleicher Breitengrad an einer Kante, gleicher Breitengrad an 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.

Hinweis: Da es sich bei MapPolygons um geografische Elemente handelt, führt das Ziehen eines MapPolygons (mit Hilfe von MouseArea oder PointHandler) dazu, dass seine Eckpunkte im geografischen Koordinatenraum neu errechnet werden. Die Kanten behalten die gleichen geografischen Längen (Breiten- und Längengraddifferenzen zwischen den Scheitelpunkten), aber sie bleiben gerade. Das Element wird scheinbar gestreckt, wenn es auf einen anderen Breitengrad gezogen wird.

Beispielverwendung

Der folgende Ausschnitt zeigt ein MapPolygon, das zur Darstellung eines Dreiecks mit drei Scheitelpunkten in der Nähe von Brisbane, Australien, verwendet wird. Das Dreieck ist grün gefüllt und hat einen schwarzen Rand von 1 Pixel.

Map {
    MapPolygon {
        color: 'green'
        path: [
            { latitude: -27, longitude: 153.0 },
            { latitude: -27, longitude: 154.1 },
            { latitude: -28, 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.

border group
border.color : color
border.width : int

Diese Eigenschaft ist Teil der Eigenschaftsgruppe border. Die Eigenschaftsgruppe border enthält die Breite und Farbe, mit der der Rand des Polygons gezeichnet wird.

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.

color : color

Diese Eigenschaft enthält die Farbe, die zum Füllen des Polygons verwendet wird.

Der Standardwert ist transparent.

path : list<coordinate>

Diese Eigenschaft enthält die geordnete Liste der Koordinaten, die das Polygon definieren. Wenn weniger als 3 verschiedene Koordinaten im Pfad vorhanden sind, führt dies zu einem undefinierten Verhalten.

Siehe auch addCoordinate und removeCoordinate.

referenceSurface : enum [since 6.5]

Diese Eigenschaft bestimmt die Referenzfläche des Polygons. Wenn sie auf QLocation::ReferenceSurface::Map gesetzt ist, werden die Eckpunkte des Polygons mit geraden Linien auf der Karte verbunden. Wenn sie auf QLocation::ReferenceSurface::Globe gesetzt ist, werden die Scheitelpunkte entsprechend dem Großkreispfad 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 zum Pfad hinzu.

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