MapRectangle QML Type

Le type MapRectangle permet d'afficher un rectangle sur une carte. Plus d'informations...

• 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.

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

Documentation sur les propriétés

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. Si vous attribuez la valeur false à cette propriété, 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.

border group

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 une absence de ligne, utilisez 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é définit 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 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 souris, 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 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 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 supérieure gauche du site MapRectangle qui peut être utilisée pour récupérer sa longitude, sa latitude et son altitude.