MapRectangle QML Type

Le type MapRectangle affiche un rectangle sur une carte. En savoir plus…

• 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 affiche un rectangle sur une carte. Les rectangles constituent un cas particulier de polygone comportant 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 (le côté supérieur), et que le point inférieur gauche a la même latitude que le point inférieur droit (le côté inférieur). De même, les points situés à gauche ont la même longitude, et ceux situés à droite ont la même longitude.

Pour définir le rectangle, il faut indiquer un point « topLeft » et un point « bottomRight », tous deux spécifiés par un « geoCoordinate ».

Par défaut, le rectangle s’affiche avec un remplissage transparent et une bordure noire d’une épaisseur de 1 pixel. Ces paramètres peuvent être modifiés à l’aide des propriétés color, border.color et border.width.

Exemple d'utilisation

L'extrait de code 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 de 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
        }
    }
}

Documentation des propriétés

autoFadeIn : bool

Cette propriété détermine si l'élément apparaît progressivement lorsque l'on effectue un zoom avant sur la carte à partir de niveaux de zoom très faibles. Par défaut, la valeur est « true ». Si vous définissez 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 », dont la valeur par défaut est 1,0.

border group

Cette propriété fait partie du groupe de propriétés « border ». Ce groupe de propriétés définit la largeur et la couleur utilisées pour tracer le contour 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 ne pas afficher de ligne, utilisez une largeur de 0 ou une couleur transparente.

bottomRight : coordinate

Cette propriété contient la coordonnée en bas à droite de l'MapRectangle, qui peut être utilisée pour récupérer sa longitude, sa latitude et son altitude.

color : color

Cette propriété définit la couleur de remplissage du rectangle. Pour ne pas appliquer de remplissage, utilisez une couleur transparente.

opacity : real

Cette propriété définit l'opacité de l'élément. L'opacité est spécifiée par un nombre compris entre 0 (entièrement transparent) et 1 (entièrement opaque). La valeur par défaut est 1.

Un élément dont l'opacité est égale à 0 continuera de recevoir des événements de souris. Pour désactiver ces événements, définissez la propriété « visible » de l'élément sur « false ».

referenceSurface : enum [since 6.5]

Cette propriété détermine la surface de référence du rectangle. Si elle est définie sur « QLocation::ReferenceSurface::Map », les points aux extrémités des arêtes sont reliés par des lignes droites sur la carte. Si elle est définie sur « QLocation::ReferenceSurface::Globe », les points aux extrémités des arêtes sont reliés en suivant le chemin orthodromique, qui représente la liaison 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 en haut à gauche de l'MapRectangle, qui peut être utilisée pour récupérer sa longitude, sa latitude et son altitude.