MapRectangle QML Type

Der Typ „MapRectangle“ zeigt ein Rechteck auf einer Karte an. Mehr...

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

Eigenschaften

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

Ausführliche Beschreibung

Der Typ „MapRectangle“ zeigt ein Rechteck auf einer Karte an. Rechtecke sind ein Sonderfall von Polygonen mit genau 4 Eckpunkten und 4 „geraden“ Kanten. In diesem Fall bedeutet „gerade“, dass der Punkt oben links denselben Breitengrad hat wie der Punkt oben rechts (die obere Kante) und der Punkt unten links denselben Breitengrad wie der Punkt unten rechts (die untere Kante). Ebenso haben die Punkte auf der linken Seite denselben Längengrad und die Punkte auf der rechten Seite denselben Längengrad.

Zur Festlegung des Rechtecks sind die Punkte „ topLeft “ und „ bottomRight “ erforderlich, die beide durch „ geoCoordinate “ angegeben werden.

Standardmäßig wird das Rechteck mit transparenter Füllung und einem 1 Pixel dicken schwarzen Rand angezeigt. Dies kann mithilfe der Eigenschaften „ color “, „ border.color “ und „ border.width “ geändert werden.

Anwendungsbeispiel

Der folgende Codeausschnitt zeigt eine Karte mit einem „MapRectangle“, das sich von (-27, 153) bis (-28, 153,5) in der Nähe von Brisbane, Australien, erstreckt. Das Rechteck ist grün ausgefüllt und hat einen 2-Pixel-breiten schwarzen Rand.

Map {
    MapRectangle {
        color: 'green'
        border.width: 2
        topLeft {
            latitude: -27
            longitude: 153
        }
        bottomRight {
            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 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.

border group

Diese Eigenschaft gehört zur Eigenschaftsgruppe „border“. Die Eigenschaftsgruppe „border“ enthält die Breite und die Farbe, die zum Zeichnen des Rahmens des Rechtecks 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.

bottomRight : coordinate

Diese Eigenschaft enthält die Koordinate der unteren rechten Ecke des „ MapRectangle “, anhand derer dessen Längengrad, Breitengrad und Höhe ermittelt werden können.

color : color

Diese Eigenschaft legt die Füllfarbe des Rechtecks 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“.

referenceSurface : enum [since 6.5]

Diese Eigenschaft legt die Bezugsebene des Rechtecks fest. Wenn sie auf „ QLocation::ReferenceSurface::Map “ gesetzt ist, werden die Kantenpunkte auf der Karte durch gerade Linien verbunden. Wenn sie auf „ QLocation::ReferenceSurface::Globe “ gesetzt ist, werden die Kantenpunkte 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.

topLeft : coordinate

Diese Eigenschaft enthält die Koordinate der oberen linken Ecke des „ MapRectangle “, anhand derer dessen Längen- und Breitengrad sowie die Höhe ermittelt werden können.