MapCircle QML Type

Der Typ MapCircle zeigt einen geografischen Kreis auf einer Karte an. Mehr...

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

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

Eigenschaften

autoFadeIn : bool
border
- border.color : color
- border.width : int
center : coordinate
color : color
opacity : real
radius : real
referenceSurface : enum (since 6.5)

Detaillierte Beschreibung

Der Typ MapCircle stellt einen geografischen Kreis auf einer Karte dar, der aus allen Punkten besteht, die sich innerhalb einer bestimmten Entfernung von einem zentralen Punkt befinden. Je nach Kartenprojektion ist ein geografischer Kreis nicht immer ein perfekter Kreis auf dem Bildschirm: Bei der Mercator-Projektion beispielsweise werden Kreise in der Nähe der Pole eiförmig. Um einen perfekten Kreis um einen Punkt auf dem Bildschirm darzustellen, verwenden Sie stattdessen eine MapQuickItem, die einen entsprechenden Qt Quick Typ enthält.

Standardmäßig wird der Kreis als 1 Pixel breiter schwarzer Rand ohne Füllung angezeigt. Um sein Aussehen zu ändern, verwenden Sie die Eigenschaften color, border.color und border.width.

Intern ist ein MapCircle als ein vielseitiges Polygon implementiert. Zur Berechnung der Radiuspunkte wird ein sphärisches Modell der Erde verwendet, ähnlich wie bei der atDistanceAndAzimuth Methode des coordinate Typs. Diese beiden Dinge können gelegentlich Auswirkungen auf die Genauigkeit der Kreisform haben, je nach Position und Kartenprojektion.

Hinweis: Das Ziehen eines MapCircle (durch die Verwendung von MouseArea oder PointHandler) bewirkt, dass neue Punkte im gleichen Abstand (in Metern) vom Mittelpunkt erzeugt werden. Dies steht im Gegensatz zu anderen Kartenelementen, die ihre Dimensionen in Form von Breiten- und Längengraddifferenzen zwischen den Eckpunkten speichern.

Verwendungsbeispiel

Der folgende Ausschnitt zeigt eine Karte, die einen MapCircle mit der Koordinate (-27, 153) als Mittelpunkt und einem Radius von 5 km enthält. Der Kreis ist grün ausgefüllt, mit einem schwarzen Rand von 3 Pixeln.

Map {
    MapCircle {
        center {
            latitude: -27.5
            longitude: 153.0
        }
        radius: 5000.0
        color: 'green'
        border.width: 3
    }
}

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 Gruppeneigenschaft border. Die Eigenschaft border enthält die Breite und Farbe, mit der der Rand des Kreises 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.

center : coordinate

Diese Eigenschaft enthält den zentralen Punkt, um den der Kreis definiert ist.

Siehe auch radius.

color : color

Diese Eigenschaft enthält die Füllfarbe des Kreises, wenn er gezeichnet wird. Wenn Sie keine Füllung wünschen, verwenden Sie eine transparente Farbe.

opacity : real

Diese Eigenschaft gibt die Deckkraft des Elements an. Die Deckkraft wird als Zahl zwischen 0 (völlig transparent) und 1 (völlig undurchsichtig) angegeben. Die Standardeinstellung ist 1.

Ein Element mit einer Deckkraft von 0 empfängt weiterhin Mausereignisse. Um Mausereignisse zu unterbinden, setzen Sie die Eigenschaft visible des Elements auf false.

radius : real

Diese Eigenschaft enthält den Radius des Kreises in Metern auf dem Boden.

Siehe auch center.

referenceSurface : enum [since 6.5]

Diese Eigenschaft bestimmt die Bezugsfläche des Kreises. Wenn sie auf QLocation::ReferenceSurface::Map gesetzt ist, wird der Kreis als Kreis auf der Karte gezeichnet, wobei radius dem Kartenmaßstab in der Mitte des Kreises angenähert ist. Wenn sie auf QLocation::ReferenceSurface::Globe gesetzt ist, wird der Kreis auf eine Kugel abgebildet und der Großkreispfad wird verwendet, um die Abdeckung des Kreises zu bestimmen. Der Standardwert ist QLocation::ReferenceSurface::Map.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.

© 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.