MapRectangle QML Type
Le type MapRectangle permet d'afficher un rectangle sur une carte. Plus d'informations...
| Import Statement: | import QtLocation 6.10 |
| Since: | QtLocation 5.5 |
- Liste de tous les membres, y compris les membres hérités
- MapRectangle fait partie du plugin QML Maps.
Propriétés
- autoFadeIn : bool
- border
- border.color : color
- border.width : int
- bottomRight : coordinate
- color : color
- opacity : real
- referenceSurface : enum
(since 6.5) - topLeft : coordinate
Description détaillée
Le type MapRectangle permet d'afficher un rectangle sur une carte. Les rectangles sont un cas particulier de polygone avec exactement 4 sommets et 4 arêtes "droites". Dans ce cas, "droit" signifie que le point supérieur gauche a la même latitude que le point supérieur droit (l'arête supérieure), et que le point inférieur gauche a la même latitude que le point inférieur droit (l'arête inférieure). De même, les points du côté gauche ont la même longitude, et les points du côté droit ont la même longitude.
Pour spécifier le rectangle, il faut un point topLeft et un point bottomRight, tous deux donnés par une coordonnée.
Par défaut, le rectangle est affiché avec un remplissage transparent et une bordure noire de 1 pixel d'épaisseur. Ceci peut être modifié à l'aide des propriétés color, border.color et border.width.
Remarque : à l'instar du type MapPolygon, les MapRectangles sont des éléments géographiques. Par conséquent, le déplacement d'un MapRectangle entraîne le recalcul de ses sommets dans l'espace des coordonnées géographiques. Un étirement apparent de l'élément se produit lorsqu'il est déplacé vers une latitude différente, mais ses arêtes restent droites.
Exemple d'utilisation
L'extrait suivant montre une carte contenant un MapRectangle, s'étendant de (-27, 153) à (-28, 153.5), près de Brisbane, en Australie. Le rectangle est rempli en vert, avec une bordure noire de 2 pixels.
Map { MapRectangle { color: 'green' border.width: 2 topLeft { latitude: -27 longitude: 153 } bottomRight { latitude: -28 longitude: 153.5 } } }

Propriété Documentation
autoFadeIn : bool |
Cette propriété indique si l'élément s'estompe automatiquement lorsque l'on zoome sur la carte à partir d'un niveau de zoom très bas. La valeur par défaut est true. En définissant cette propriété sur false, l'élément de la carte aura toujours l'opacité spécifiée par la propriété QtQuick::Item::opacity, qui est de 1,0 par défaut.
Cette propriété fait partie du groupe de propriétés "border". Le groupe de propriétés border contient la largeur et la couleur utilisées pour dessiner la bordure du rectangle. La largeur est exprimée en pixels et est indépendante du niveau de zoom de la carte.
Les valeurs par défaut correspondent à une bordure noire d'une largeur de 1 pixel. Pour l'absence de ligne, utiliser une largeur de 0 ou une couleur transparente.
bottomRight : coordinate |
Cette propriété contient la coordonnée en bas à droite du site MapRectangle qui peut être utilisée pour récupérer sa longitude, sa latitude et son altitude.
color : color |
Cette propriété contient la couleur de remplissage du rectangle. Si le rectangle n'est pas rempli, utilisez une couleur transparente.
opacity : real |
Cette propriété définit l'opacité de l'élément. L'opacité est spécifiée sous la forme d'un nombre compris entre 0 (totalement transparent) et 1 (totalement opaque). La valeur par défaut est 1.
Un élément dont l'opacité est de 0 recevra toujours des événements de souris. Pour arrêter les événements de la souris, définissez la propriété visible de l'élément sur false (faux).
referenceSurface : enum |
Cette propriété détermine la surface de référence du rectangle. Si elle est définie sur QLocation::ReferenceSurface::Map, les points de bord sont reliés par des lignes droites sur la carte. Si la valeur est QLocation::ReferenceSurface::Globe, les points du bord sont reliés en suivant la trajectoire du grand cercle, qui décrit la connexion la plus courte entre deux points sur une sphère. La valeur par défaut est QLocation::ReferenceSurface::Map.
Cette propriété a été introduite dans Qt 6.5.
topLeft : coordinate |
Cette propriété contient la coordonnée supérieure gauche de MapRectangle qui peut être utilisée pour récupérer sa longitude, sa latitude et son altitude.
© 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.