Sur cette page

geoShape QML Value Type

Un type « geoShape » représente une zone géographique abstraite. En savoir plus…

Import Statement: import QtPositioning

Propriétés

Méthodes

Description détaillée

Ce type est une représentation QML de ` QGeoShape `, qui désigne 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 ` permet de vérifier 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 l'aire géométrique est égale à 0.

La méthode contains() permet de vérifier si une 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++, notez que toute valeur ` QGeoShape ` transmise à QML depuis C++ est automatiquement convertie en valeur `geoShape`, et inversement.

Documentation des propriétés

isEmpty : bool

Indique si cette figure est vide. Une figure vide est une région dont l'aire géométrique est égale à 0.

isValid : bool

Indique si cette forme est valide.

Une forme est considérée comme non valide 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 avec 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 une « geoRectangle ».
  • GeoShape.CircleType - La forme est une « geoCircle ».
  • GeoShape.PathType - La forme est une « geoPath ». (Depuis Qt 5.9)
  • GeoShape.PolygonType - La forme est une « 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)

Renvoie « true » si l'coordinate e spécifiée par ` coord ` se trouve dans cette forme ; sinon, renvoie « false ».

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