geoRectangle QML Value Type

Le type geoRectangle représente une zone géographique rectangulaire. En savoir plus...

Propriétés

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

Description détaillée

Le type geoRectangle est une entité géographique ( geoShape ) qui représente une zone géographique rectangulaire. Ce type correspond à la représentation directe d'un rectangle géographique ( QGeoRectangle). Il est défini par une paire de coordonnées ( coordinates ) qui représentent les coins supérieur gauche et inférieur droit du rectangle. Ces coordonnées sont accessibles via les attributs topLeft et bottomRight.

Un rectangle est considéré comme non valide si les coordonnées du coin supérieur gauche ou du coin inférieur droit sont non valides, ou si la coordonnée du coin supérieur gauche se trouve au sud de celle du coin inférieur droit.

Les coordonnées des quatre coins du rectangle sont accessibles via les attributs topLeft, topRight, bottomLeft et bottomRight. L’attribut center permet d’obtenir la coordonnée du centre du rectangle. Les attributs width et height permettent d’obtenir la largeur et la hauteur du rectangle en degrés. La définition de l’un de ces attributs entraîne l’ajustement correspondant des autres attributs.

Limitations

Un geoRectangle ne peut jamais traverser les pôles.

Si la hauteur ou le centre d’un geoRectangle est ajusté de telle sorte qu’il traverse l’un des pôles, la hauteur est modifiée pour que le rectangle touche le pôle sans le traverser et que les coordonnées du centre restent au centre du rectangle.

Exemple d’utilisation

Pour créer une valeur geoRectangle, utilisez la fonction QtPositioning.rectangle() :

import QtPositioning

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

Lors de l'intégration avec C++, notez que toute valeur de type ` QGeoRectangle ` transmise à QML depuis C++ est automatiquement convertie en une valeur de type `geoRectangle`, et inversement.

Documentation des propriétés

bottomLeft : geoCoordinate

Cette propriété contient la coordonnée du coin inférieur gauche de cette geoRectangle.

bottomRight : geoCoordinate

Cette propriété contient la coordonnée du coin inférieur droit de cette geoRectangle.

center : geoCoordinate

Cette propriété contient les coordonnées du centre de cette geoRectangle. Pour plus d'informations, consultez QGeoRectangle::setCenter().

height : double

Cette propriété contient la hauteur de cette geoRectangle (en degrés). Pour plus de détails, consultez QGeoRectangle::setHeight().

topLeft : geoCoordinate

Cette propriété contient la coordonnée du coin supérieur gauche de cette geoRectangle.

topRight : geoCoordinate

Cette propriété contient la coordonnée du coin supérieur droit de cette geoRectangle.

width : double

Cette propriété contient la largeur de cette geoRectangle (en degrés). Pour plus de détails, consultez QGeoRectangle::setWidth().