MapRectangle QML Type

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

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

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

Eigenschaften

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

Detaillierte Beschreibung

Der Typ MapRectangle stellt ein Rechteck auf einer Karte dar. Rechtecke sind ein Spezialfall von Polygonen mit genau 4 Scheitelpunkten und 4 "geraden" Kanten. In diesem Fall bedeutet "gerade", dass der obere linke Punkt denselben Breitengrad hat wie der obere rechte Punkt (die obere Kante) und der untere linke Punkt denselben Breitengrad wie der untere rechte Punkt (die untere Kante). In ähnlicher Weise haben die Punkte auf der linken Seite denselben Längengrad und die Punkte auf der rechten Seite denselben Längengrad.

Um das Rechteck zu definieren, werden die Punkte topLeft und bottomRight benötigt, die beide durch coordinate angegeben werden.

Standardmäßig wird das Rechteck mit einer transparenten Füllung und einem 1 Pixel dicken schwarzen Rand angezeigt. Dies kann mit den Eigenschaften color, border.color und border.width geändert werden.

Hinweis: Ähnlich wie beim Typ MapPolygon handelt es sich bei MapRectangles um geografische Elemente, so dass beim Ziehen eines MapRectangles dessen Eckpunkte im geografischen Koordinatenraum neu berechnet werden. Das Element wird scheinbar gestreckt, wenn es auf einen anderen Breitengrad gezogen wird, seine Kanten bleiben jedoch gerade.

Beispielverwendung

Der folgende Ausschnitt zeigt eine Karte, die ein MapRectangle enthält, das sich von (-27, 153) bis (-28, 153,5) in der Nähe von Brisbane, Australien, erstreckt. Das Rechteck ist grün gefüllt und hat einen schwarzen Rand von 2 Pixeln.

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

bottomRight : coordinate

Diese Eigenschaft enthält die untere rechte Koordinate von MapRectangle, die zum Abrufen von Längen- und Breitengraden sowie der Höhe verwendet werden kann.

color : color

Diese Eigenschaft enthält die Füllfarbe des Rechtecks. Für keine Füllung 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.

referenceSurface : enum [since 6.5]

Diese Eigenschaft bestimmt die Bezugsfläche des Rechtecks. Wenn sie auf QLocation::ReferenceSurface::Map eingestellt ist, werden die Kantenpunkte mit geraden Linien auf der Karte verbunden. Wenn sie auf QLocation::ReferenceSurface::Globe gesetzt ist, werden die Randpunkte entlang des Großkreispfades verbunden, der die kürzeste Verbindung zweier Punkte 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 linke obere Koordinate von MapRectangle, die verwendet werden kann, um den Längen- und Breitengrad sowie die Höhe abzurufen.

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