MapCircle QML Type

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

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

Eigenschaften

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

Ausführliche Beschreibung

Der Typ „MapCircle“ zeigt auf einer Karte einen geographischen Kreis an, der aus allen Punkten besteht, die sich innerhalb einer festgelegten Entfernung von einem Mittelpunkt befinden. Je nach Kartenprojektion ist ein geografischer Kreis auf dem Bildschirm möglicherweise nicht immer ein perfekter Kreis: In der Mercator-Projektion beispielsweise nehmen Kreise in der Nähe der Pole eine eiförmige Gestalt an. Um einen perfekten Bildschirmkreis um einen Punkt herum darzustellen, verwenden Sie stattdessen einen „ MapQuickItem “, der einen entsprechenden „ Qt Quick “-Typ enthält.

Standardmäßig wird der Kreis als schwarzer Rand mit einer Breite von 1 Pixel und ohne Füllung dargestellt. Um sein Aussehen zu ändern, verwenden Sie die Eigenschaften ` color`, ` border.color ` und ` border.width `.

Intern wird ein „MapCircle“ als vielseitiges Polygon implementiert. Zur Berechnung der Radiuspunkte wird ein sphärisches Modell der Erde verwendet, ähnlich wie bei der Methode „atDistanceAndAzimuth“ von „ geoCoordinate “. Diese beiden Faktoren können gelegentlich Auswirkungen auf die Genauigkeit der Kreisform haben, abhängig von der Position und der Kartenprojektion.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt eine Karte mit einem MapCircle, dessen Mittelpunkt bei den Koordinaten (-27, 153) liegt und dessen Radius 5 km beträgt. Der Kreis ist grün ausgefüllt und hat einen 3 Pixel breiten schwarzen Rand.

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

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 hier „ true “ eingestellt. Wird diese Eigenschaft auf „ false “ gesetzt, hat das Kartenelement stets die mit der Eigenschaft „ QtQuick::Item::opacity “ festgelegte Deckkraft, die standardmäßig 1,0 beträgt.

border group

Diese Eigenschaft ist Teil der gruppierten Eigenschaft „border“. Die Eigenschaft „border“ enthält die Breite und die Farbe, die zum Zeichnen des Kreisrandes verwendet werden. Die Breite wird in Pixeln angegeben und ist unabhängig vom Zoomfaktor der Karte.

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

center : coordinate

Diese Eigenschaft bezeichnet den Mittelpunkt, um den der Kreis definiert ist.

Siehe auch radius.

color : color

Diese Eigenschaft legt die Füllfarbe des Kreises beim Zeichnen fest. Wenn keine Füllung gewünscht ist, verwenden Sie eine transparente Farbe.

opacity : real

Diese Eigenschaft gibt die Deckkraft des Elements an. Die Deckkraft wird als Zahl zwischen 0 (vollständig transparent) und 1 (vollständig undurchsichtig) angegeben. Der Standardwert 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 gibt den Radius des Kreises in Metern auf dem Boden an.

Siehe auch „ center “.

referenceSurface : enum [since 6.5]

Diese Eigenschaft legt die Referenzfläche des Kreises fest. Wenn sie auf „ QLocation::ReferenceSurface::Map “ gesetzt ist, wird der Kreis als Kreis auf der Karte gezeichnet, wobei „ radius “ so angepasst wird, dass er dem Kartenmaßstab im Mittelpunkt des Kreises entspricht. Wenn sie auf „ QLocation::ReferenceSurface::Globe “ gesetzt ist, wird der Kreis auf eine Kugel abgebildet, und der Großkreisweg wird verwendet, um die Abdeckung des Kreises zu bestimmen. Der Standardwert ist „ QLocation::ReferenceSurface::Map “.

Diese Eigenschaft wurde in Qt 6.5 eingeführt.