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

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 von coordinates definiert, die die obere linke und die untere rechte Ecke des Rechtecks darstellen. Die Koordinaten sind über die Attribute topLeft und bottomRight zugänglich.

Ein Rechteck 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 des Rechtecks kann mit den Attributen topLeft, topRight, bottomLeft und bottomRight zugegriffen werden. Das Attribut center kann verwendet werden, um die Koordinaten des Mittelpunkts des Rechtecks zu ermitteln. Die Attribute width und height können verwendet werden, um die Breite und Höhe des Rechtecks 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 es einen der Pole überqueren würde, wird die Höhe so geändert, dass das Rechteck den Pol berührt, aber nicht überquert, und dass die Mittelpunktskoordinate immer noch in der Mitte des Rechtecks liegt.

Beispielverwendung

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))
}

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.

Eigenschaft Dokumentation