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.