Sur cette page

QGeoShape Class

La classe QGeoShape définit une zone géographique. Plus d'informations...

En-tête : #include <QGeoShape>
CMake : find_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmake : QT += positioning
Héritée 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 pour les 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 QGeoCoordinate et de distances en mètres.

Cette classe est également accessible en QML sous la forme geoShape.

Documentation sur les types de membres

enum QGeoShape::ShapeType

Décrit le type de la forme.

ConstanteValeurDescription de la forme
QGeoShape::UnknownType0Forme de type inconnu
QGeoShape::RectangleType1Une forme rectangulaire
QGeoShape::CircleType2Une forme circulaire
QGeoShape::PathType3Un type de chemin
QGeoShape::PolygonType4Un type de polygone

Documentation sur les propriétés

[read-only] center : QGeoCoordinate

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

Fonctions d'accès :

QGeoCoordinate center() const

[read-only] isEmpty : bool

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

Une géoforme vide est une région dont la surface géométrique est égale à 0.

Bien que cette propriété ait été introduite dans Qt 5.5, les fonctions d'accès correspondantes 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éométrique.

Une forme géométrique est considérée comme non valide si certaines des données requises pour décrire sans ambiguïté la forme géométrique n'ont pas été définies ou ont été définies à une valeur inappropriée, en fonction de la sous-classe de cet objet. Les objets construits par défaut de ce type sont invalides.

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

Fonctions d'accès :

bool isValid() const

[read-only] type : ShapeType

Cette propriété contient le type de cette forme géographique.

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

Fonctions d'accès :

QGeoShape::ShapeType type() const

Documentation des fonctions membres

QGeoShape::QGeoShape()

Construit une nouvelle forme géographique invalide de UnknownType.

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

Construit une nouvelle forme géographique qui est une copie de other.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

[noexcept] QGeoShape::~QGeoShape()

Détruit cette forme géographique.

[invokable] QGeoRectangle QGeoShape::boundingGeoRectangle() const

Renvoie une adresse QGeoRectangle représentant le rectangle de délimitation géographique de la forme géographique, qui définit les limites latitudinales/longitudinales de la forme géographique.

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

QGeoCoordinate QGeoShape::center() const

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

Remarque : fonction Getter pour la propriété center.

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

Indique si la coordonnée coordinate est contenue dans cette forme géographique.

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

bool QGeoShape::isEmpty() const

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

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

Remarque : fonction Getter pour la propriété isEmpty.

bool QGeoShape::isValid() const

Retourne si cette forme géométrique est valide.

Remarque : fonction Getter 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éographique.

Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.

QGeoShape::ShapeType QGeoShape::type() const

Renvoie le type de cette forme géométrique.

Remarque : fonction Getter pour le type de propriété.

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

Attribue other à cette forme géométrique et renvoie une référence à cette forme géométrique.

Non-membres associés

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

Renvoie la valeur de hachage pour 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 à la forme géographique 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.