geoRectangle QML Value Type

Der Typ „geoRectangle“ stellt ein rechteckiges geografisches Gebiet dar. Mehr...

Eigenschaften

• bottomLeft : geoCoordinate
• bottomRight : geoCoordinate
• center : geoCoordinate
• height : double
• topLeft : geoCoordinate
• topRight : geoCoordinate
• width : double

Ausführliche Beschreibung

Der Typ „geoRectangle“ ist ein „ geoShape “, der ein rechteckiges geografisches Gebiet darstellt. Der Typ ist eine direkte Darstellung eines „ QGeoRectangle “. Er wird durch ein Koordinatenpaar „ coordinates “ definiert, das die obere linke und die untere rechte Ecke des Rechtecks angibt. Die Koordinaten sind über die Attribute „ topLeft “ und „ bottomRight “ zugänglich.

Ein Rechteck gilt als ungültig, wenn die Koordinaten der oberen linken oder unteren rechten Ecke ungültig sind oder wenn die Koordinate der oberen linken Ecke südlich der Koordinate der unteren rechten Ecke liegt.

Die Koordinaten der vier Ecken des Rechtecks sind über die Attribute „ topLeft “, „ topRight “, „ bottomLeft “ und „ bottomRight “ abrufbar. Mit dem Attribut „ center “ lässt sich die Koordinate des Mittelpunkts des Rechtecks abrufen. Die Attribute „ width “ und „ height “ dienen dazu, die Breite und Höhe des Rechtecks in Grad abzurufen. Wird eines dieser Attribute festgelegt, werden die anderen Attribute entsprechend angepasst.

Einschränkungen

Ein „geoRectangle“ darf niemals die Pole überqueren.

Wird die Höhe oder der Mittelpunkt eines geoRectangle so angepasst, dass es einen der Pole überschreiten würde, wird die Höhe so geändert, dass das Rechteck den Pol berührt, ihn aber nicht überschreitet, und dass die Koordinate des Mittelpunkts weiterhin im Mittelpunkt des Rechtecks liegt.

Anwendungsbeispiel

Um einen geoRectangle-Wert zu erstellen, verwenden Sie die Funktion ` QtPositioning.rectangle()`:

import QtPositioning

Item {
    property geoRectangle region: QtPositioning.rectangle(QtPositioning.coordinate(-27.5, 153.1),
                                                          QtPositioning.coordinate(-27.6, 153.2))
}

Beachten Sie bei der Integration mit C++, dass jeder aus C++ an QML übergebene QGeoRectangle -Wert automatisch in einen geoRectangle-Wert umgewandelt wird und umgekehrt.

Dokumentation zu den Eigenschaften

bottomLeft : geoCoordinate

Diese Eigenschaft enthält die Koordinate der unteren linken Ecke dieses geoRectangle.

bottomRight : geoCoordinate

Diese Eigenschaft enthält die Koordinate der unteren rechten Ecke dieses geoRectangle.

center : geoCoordinate

Diese Eigenschaft enthält die Mittelkoordinate dieses geoRectangle. Weitere Informationen finden Sie unter QGeoRectangle::setCenter().

height : double

Diese Eigenschaft enthält die Höhe dieses geoRectangle (in Grad). Weitere Informationen finden Sie unter QGeoRectangle::setHeight().

topLeft : geoCoordinate

Diese Eigenschaft enthält die Koordinate der oberen linken Ecke dieses geoRectangle.

topRight : geoCoordinate

Diese Eigenschaft enthält die Koordinate der oberen rechten Ecke dieses geoRectangle.

width : double

Diese Eigenschaft enthält die Breite dieses geoRectangle (in Grad). Weitere Informationen finden Sie unter QGeoRectangle::setWidth().