Sur cette page

geoShape QML Value Type

Un type geoShape représente une zone géographique abstraite. Plus d'informations...

Import Statement: import QtPositioning

Propriétés

Méthodes

Description détaillée

Ce type est une représentation QML de QGeoShape qui est une zone géographique abstraite. Il comprend des attributs et des méthodes communs à toutes les zones géographiques. Pour créer des objets représentant une zone géographique valide, utilisez geoRectangle ou geoCircle.

L'attribut isValid peut être utilisé pour tester si la forme représente une zone géographique valide.

L'attribut isEmpty permet de vérifier si la forme représente une région dont la surface géométrique est égale à 0.

La méthode contains() peut être utilisée pour vérifier si un geoCoordinate se trouve à l'intérieur de la forme.

Exemple d'utilisation

Pour créer une valeur geoShape, utilisez la fonction QtPositioning.shape() :

import QtPositioning

Item {
    property geoShape region: QtPositioning.shape()
}

Lors de l'intégration avec C++, il convient de noter que toute valeur QGeoShape transmise à QML à partir de C++ est automatiquement convertie en valeur geoShape, et vice-versa.

Documentation sur les propriétés

isEmpty : bool

Retourne si cette forme est vide. Une forme vide est une région dont la surface géométrique est égale à 0.

isValid : bool

Indique si cette forme est valide.

Une forme est considérée comme invalide si certaines des données nécessaires pour la décrire sans ambiguïté n'ont pas été définies ou ont été définies à une valeur inappropriée.

type : ShapeType

Renvoie le type actuel de la forme.

  • GeoShape.UnknownType - Le type de la forme n'est pas connu.
  • GeoShape.RectangleType - La forme est un geoRectangle.
  • GeoShape.CircleType - La forme est un geoCircle.
  • GeoShape.PathType - La forme est un geoPath. (Depuis Qt 5.9)
  • GeoShape.PolygonType - La forme est un geoPolygon. (Depuis Qt 5.10)

Cette propriété QML a été introduite par Qt 5.5.

Documentation de la méthode

bool contains(geoCoordinate coord)

Retourne vrai si le site coordinate spécifié par coord se trouve à l'intérieur de cette forme ; sinon, retourne faux.

© 2026 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.