georectangle QML Value Type
Der Typ Georechteck stellt ein rechteckiges geografisches Gebiet dar. Mehr...
Import Statement: | import QtPositioning |
Detaillierte Beschreibung
Der Typ georectangle
ist ein geoshape, der ein rechteckiges geografisches Gebiet darstellt. Der Typ ist die direkte Darstellung eines QGeoRectangle. Er wird durch ein Paar coordinates definiert, das die obere linke und untere rechte Ecke des georectangle
darstellt. Die Koordinaten sind über die Attribute topLeft und bottomRight zugänglich.
Ein georectangle
gilt als ungültig, wenn die Koordinaten oben links oder unten rechts ungültig sind oder wenn die Koordinate oben links südlich der Koordinate unten rechts liegt.
Auf die Koordinaten der vier Ecken von georectangle
kann mit den Attributen topLeft, topRight, bottomLeft und bottomRight zugegriffen werden. Das Attribut center kann verwendet werden, um die Koordinate des Mittelpunkts von georectangle
zu erhalten. Die Attribute width und height können verwendet werden, um die Breite und Höhe von georectangle
in Grad zu erhalten. Wird eines dieser Attribute gesetzt, so werden die anderen Attribute entsprechend angepasst.
Beschränkungen
Ein georectangle
kann niemals die Pole kreuzen.
Wenn die Höhe oder der Mittelpunkt eines georectangle
so angepasst wird, dass er einen der Pole überqueren würde, wird die Höhe so geändert, dass das georectangle
den Pol berührt, aber nicht überquert, und dass die Mittelpunktskoordinate immer noch in der Mitte des georectangle
liegt.
Beispiel für die Verwendung
Verwenden Sie Eigenschaften vom Typ var, um einen georectangle
zu speichern. Um einen georectangle
Wert zu erstellen, verwenden Sie die Funktion QtPositioning.rectangle():
import QtPositioning Item { property var region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1), QtPositioning.coordinate(-27.6, 153.2)) }
Bei der Integration mit C++ ist zu beachten, dass jeder QGeoRectangle Wert, der von C++ an QML übergeben wird, automatisch in einen georectangle
Wert umgewandelt wird und umgekehrt.
Eigenschaften
bottomLeft
coordinate bottomLeft
Diese Eigenschaft enthält die untere linke Koordinate des Geodreiecks.
untenRechts
coordinate bottomRight
Diese Eigenschaft enthält die untere rechte Koordinate des Geodreiecks.
center
coordinate center
Diese Eigenschaft enthält die Mittelpunktskoordinate des Geodreiecks. Für weitere Details siehe QGeoRectangle::setCenter().
height
double height
Diese Eigenschaft enthält die Höhe des Geodreiecks (in Grad). Für weitere Details siehe QGeoRectangle::setHeight().
Hinweis: Wenn das Geodreieck ungültig ist, ist es nicht möglich, die Höhe zu setzen. QtPositioning Versionen vor Qt 5.5 erlaubten das Setzen der Höhe auch bei ungültigen Geodreiecken.
topLeft
coordinate topLeft
Diese Eigenschaft enthält die obere linke Koordinate des Geodreiecks.
topRight
coordinate topRight
Diese Eigenschaft enthält die obere rechte Koordinate des Geodreiecks.
width
double width
Diese Eigenschaft enthält die Breite des Geodreiecks (in Grad). Für weitere Details siehe QGeoRectangle::setWidth().
Hinweis: Wenn das Geodreieck ungültig ist, ist es nicht möglich, die Breite zu setzen. QtPositioning Versionen vor Qt 5.5 erlaubten das Setzen der Breite auch bei ungültigen Geodreiecken.
© 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.