Sur cette page

QGeoShape Class

La classe QGeoShape définit une zone géographique. En savoir plus...

En-tête : #include <QGeoShape>
CMake : find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake : QT += positioning
Hérité par :

QGeoCircle, QGeoPath, QGeoPolygon, et QGeoRectangle

Types publics

enum ShapeType { UnknownType, RectangleType, CircleType, PathType, PolygonType }

Propriétés

Fonctions publiques

QGeoShape()
QGeoShape(const QGeoShape &other)
~QGeoShape()
QGeoRectangle boundingGeoRectangle() const
QGeoCoordinate center() const
bool contains(const QGeoCoordinate &coordinate) const
bool isEmpty() const
bool isValid() const
QString toString() const
QGeoShape::ShapeType type() const
QGeoShape &operator=(const QGeoShape &other)
size_t qHash(const QGeoShape &shape, size_t seed = 0)
bool operator!=(const QGeoShape &lhs, const QGeoShape &rhs)
bool operator==(const QGeoShape &lhs, const QGeoShape &rhs)

Description détaillée

Cette classe est la classe de base des classes qui spécifient une zone géographique.

Par souci de cohérence, les sous-classes doivent décrire les détails spécifiques des zones associées en termes d’instances de type « QGeoCoordinate » et de distances en mètres.

Cette classe est également accessible en QML sous le nom d'geoShape.

Documentation sur les types membres

enum QGeoShape::ShapeType

Décrit le type de la forme.

ConstanteValeurDescription
QGeoShape::UnknownType0Une forme de type inconnu
QGeoShape::RectangleType1Une forme rectangulaire
QGeoShape::CircleType2Une forme circulaire
QGeoShape::PathType3Un tracé
QGeoShape::PolygonType4Un type de polygone

Documentation sur les propriétés

[read-only] center : QGeoCoordinate

Cette propriété contient les coordonnées du centre géométrique de la forme.

Fonctions d'accès :

QGeoCoordinate center() const

[read-only] isEmpty : bool

Cette propriété indique si cette forme géométrique est vide.

Une forme géométrique vide est une région dont l'aire géométrique est égale à 0.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès associées existent depuis la première version de cette classe.

Fonctions d'accès :

bool isEmpty() const

[read-only] isValid : bool

Cette propriété indique la validité de la forme géographique.

Une forme géographique 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, selon la sous-classe de cet objet. Les objets de ce type créés par défaut sont non valides.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès associées existent depuis la première version de cette classe.

Fonctions d'accès :

bool isValid() const

[read-only] type : ShapeType

Cette propriété indique le type de cette forme géométrique.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès associées existent depuis la première version de cette classe.

Fonctions d'accès :

QGeoShape::ShapeType type() const

Documentation des fonctions membres

QGeoShape::QGeoShape()

Crée une nouvelle forme géographique non valide à l'adresse UnknownType.

[invokable] QGeoShape::QGeoShape(const QGeoShape &other)

Crée une nouvelle forme géométrique qui est une copie de other.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

[noexcept] QGeoShape::~QGeoShape()

Supprime cette forme géométrique.

[invokable] QGeoRectangle QGeoShape::boundingGeoRectangle() const

Renvoie un objet ` QGeoRectangle ` représentant le rectangle géographique englobant la forme géographique, qui définit les limites de latitude et de longitude de cette dernière.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

QGeoCoordinate QGeoShape::center() const

Renvoie la coordonnée située au centre géométrique de la forme géométrique.

Remarque : fonctiongetter pour la propriété center.

[invokable] bool QGeoShape::contains(const QGeoCoordinate &coordinate) const

Indique si le coordinate de coordonnées est contenu dans cette forme géométrique.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir ` Q_INVOKABLE`.

bool QGeoShape::isEmpty() const

Indique si cette forme géométrique est vide.

Une forme géométrique vide est une région dont l'aire géométrique est égale à 0.

Remarque : fonctiongetter pour la propriété isEmpty.

bool QGeoShape::isValid() const

Indique si cette forme géographique est valide.

Remarque : fonctiongetter pour la propriété isValid.

[invokable] QString QGeoShape::toString() const

Renvoie une représentation sous forme de chaîne de caractères de cette forme géométrique.

Remarque : cette fonction peut être appelée via le système de méta-objets et depuis QML. Voir Q_INVOKABLE.

QGeoShape::ShapeType QGeoShape::type() const

Renvoie le type de cette forme géographique.

Remarque : fonctiongetter pour la propriété « type ».

QGeoShape &QGeoShape::operator=(const QGeoShape &other)

Attribue la valeur « other » à cette forme géographique et renvoie une référence à celle-ci.

Éléments non membres associés

[noexcept] size_t qHash(const QGeoShape &shape, size_t seed = 0)

Renvoie la valeur de hachage de l'shape, en utilisant seed pour le calcul.

bool operator!=(const QGeoShape &lhs, const QGeoShape &rhs)

Renvoie « true » si la forme géographique lhs n'est pas équivalente à la forme géographique rhs; sinon, renvoie « false ».

bool operator==(const QGeoShape &lhs, const QGeoShape &rhs)

Renvoie « true » si la forme géographique « lhs » est équivalente à celle de « rhs » ; 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.