geoRectangle QML Value Type

Le type geoRectangle représente une zone géographique rectangulaire. Plus d'informations...

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 un geoShape qui représente une zone géographique rectangulaire. Le type est une représentation directe d'un QGeoRectangle. Il est défini par une paire de coordinates qui représentent les coins supérieur gauche et inférieur droit du rectangle. Les coordonnées sont accessibles à partir des attributs topLeft et bottomRight.

Un rectangle est considéré comme invalide si les coordonnées haut-gauche ou bas-droit sont invalides ou si la coordonnée haut-gauche est au sud de la coordonnée bas-droit.

Les coordonnées des quatre coins du rectangle sont accessibles à l'aide des attributs topLeft, topRight, bottomLeft et bottomRight. L'attribut center peut être utilisé pour obtenir les coordonnées 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 des autres attributs en conséquence.

Limitations

Un geoRectangle ne peut jamais traverser les pôles.

Si la hauteur ou le centre d'un geoRectangle est ajusté de manière à ce qu'il traverse l'un des pôles, la hauteur est modifiée de manière à ce que le rectangle touche le pôle sans le traverser et que la coordonnée centrale soit toujours 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++, il convient de noter que toute valeur QGeoRectangle transmise à QML à partir de C++ est automatiquement convertie en valeur geoRectangle, et vice-versa.

Documentation sur les propriétés

bottomLeft : geoCoordinate

Cette propriété contient la coordonnée inférieure gauche de ce site geoRectangle.

bottomRight : geoCoordinate

Cette propriété contient la coordonnée en bas à droite de ce site geoRectangle.

center : geoCoordinate

Cette propriété contient les coordonnées du centre de ce site geoRectangle. Pour plus de détails, voir QGeoRectangle::setCenter().

height : double

Cette propriété indique la hauteur du site geoRectangle (en degrés). Pour plus de détails, voir QGeoRectangle::setHeight().

topLeft : geoCoordinate

Cette propriété contient la coordonnée supérieure gauche de ce site geoRectangle.

topRight : geoCoordinate

Cette propriété contient la coordonnée en haut à droite de ce site geoRectangle.

width : double

Cette propriété indique la largeur du site geoRectangle (en degrés). Pour plus de détails, voir QGeoRectangle::setWidth().