Sur cette page

QGeoRectangle Class

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

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

Propriétés

Fonctions publiques

QGeoRectangle()
QGeoRectangle(const QGeoShape &other)
QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
QGeoRectangle(const QGeoCoordinate &center, double degreesWidth, double degreesHeight)
QGeoRectangle(const QGeoRectangle &other)
~QGeoRectangle()
QGeoCoordinate bottomLeft() const
QGeoCoordinate bottomRight() const
QGeoCoordinate center() const
bool contains(const QGeoRectangle &rectangle) const
void extendRectangle(const QGeoCoordinate &coordinate)
double height() const
bool intersects(const QGeoRectangle &rectangle) const
void setBottomLeft(const QGeoCoordinate &bottomLeft)
void setBottomRight(const QGeoCoordinate &bottomRight)
void setCenter(const QGeoCoordinate &center)
void setHeight(double degreesHeight)
void setTopLeft(const QGeoCoordinate &topLeft)
void setTopRight(const QGeoCoordinate &topRight)
void setWidth(double degreesWidth)
QString toString() const
QGeoCoordinate topLeft() const
QGeoCoordinate topRight() const
void translate(double degreesLatitude, double degreesLongitude)
QGeoRectangle translated(double degreesLatitude, double degreesLongitude) const
QGeoRectangle united(const QGeoRectangle &rectangle) const
double width() const
QGeoRectangle &operator=(const QGeoRectangle &other)
QGeoRectangle operator|(const QGeoRectangle &rectangle) const
QGeoRectangle &operator|=(const QGeoRectangle &rectangle)

Description détaillée

Le rectangle est défini par une coordonnée de coin supérieur gauche ( QGeoCoordinate ) qui spécifie la coordonnée de coin supérieur gauche du rectangle et une coordonnée de coin inférieur droit ( QGeoCoordinate ) qui spécifie la coordonnée de coin inférieur droit du rectangle.

Un rectangle géographique est considéré comme invalide si les coordonnées du coin supérieur gauche ou du coin inférieur droit sont invalides, ou si la coordonnée du coin supérieur gauche se trouve au sud de celle du coin inférieur droit.

Les rectangles géographiques ne peuvent jamais traverser les pôles.

Plusieurs méthodes se comportent comme si le rectangle géographique était défini par une coordonnée centrale, la largeur du rectangle géographique en degrés et la hauteur du rectangle géographique en degrés.

Si la hauteur ou le centre d’un rectangle géographique est ajusté de telle sorte qu’il traverserait l’un des pôles, la hauteur est modifiée de manière à ce que le rectangle géographique touche le pôle sans le traverser et que la coordonnée centrale reste au centre du rectangle géographique.

Cette classe est également accessible en QML sous le nom « geoRectangle ».

Documentation des propriétés

bottomLeft : QGeoCoordinate

Cette propriété contient la coordonnée du coin inférieur gauche de ce rectangle 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 :

QGeoCoordinate bottomLeft() const
void setBottomLeft(const QGeoCoordinate &bottomLeft)

bottomRight : QGeoCoordinate

Cette propriété contient la coordonnée du coin inférieur droit de ce rectangle 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 :

QGeoCoordinate bottomRight() const
void setBottomRight(const QGeoCoordinate &bottomRight)

center : QGeoCoordinate

Cette propriété contient le centre de ce rectangle 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 :

QGeoCoordinate center() const
void setCenter(const QGeoCoordinate &center)

Voir également QGeoShape::center.

height : double

Cette propriété contient la hauteur de ce rectangle géographique, exprimée en degrés.

La valeur de la propriété est indéfinie si ce rectangle géographique n'est pas valide.

Si la nouvelle hauteur est inférieure à 0,0 ou si ce rectangle géographique n'est pas valide, la propriété n'est pas modifiée. Pour définir les valeurs d'un rectangle géographique non valide en fonction du centre, de la largeur et de la hauteur, vous devez d'abord utiliser la méthode setCenter() afin de rendre le rectangle géographique valide.

Si la modification de la hauteur entraînait le chevauchement du rectangle géographique avec un pôle, la hauteur est ajustée de manière à ce que le rectangle géographique ne fasse que frôler le pôle.

Cette modification est effectuée de manière à ce que la coordonnée centrale reste au centre du rectangle géographique, ce qui peut entraîner un rectangle géographique dont la hauteur est inférieure à celle attendue.

La valeur 180,0 est utilisée comme hauteur uniquement si la nouvelle hauteur est supérieure ou égale à 180.

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 :

double height() const
void setHeight(double degreesHeight)

topLeft : QGeoCoordinate

Cette propriété contient la coordonnée du coin supérieur gauche de ce rectangle géographique.

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 :

QGeoCoordinate topLeft() const
void setTopLeft(const QGeoCoordinate &topLeft)

topRight : QGeoCoordinate

Cette propriété contient la coordonnée du coin supérieur droit de ce rectangle 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 :

QGeoCoordinate topRight() const
void setTopRight(const QGeoCoordinate &topRight)

width : double

Cette propriété contient la largeur de ce rectangle géographique, exprimée en degrés.

La valeur de cette propriété n'est pas définie si ce rectangle géographique n'est pas valide.

Si la nouvelle largeur est inférieure à 0,0 ou si ce rectangle géographique n'est pas valide, cette fonction ne fait rien. Pour définir les valeurs d'un rectangle géographique non valide en fonction du centre, de la largeur et de la hauteur, vous devez d'abord utiliser la fonction setCenter() afin de rendre le rectangle géographique valide.

La valeur 360,0 est utilisée comme largeur uniquement si la nouvelle largeur est égale ou supérieure à 360. Dans ce cas, la longitude la plus à gauche du rectangle géographique est définie à -180,0 degrés et la longitude la plus à droite à 180,0 degrés.

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 :

double width() const
void setWidth(double degreesWidth)

Documentation des fonctions membres

QGeoRectangle::QGeoRectangle()

Crée un nouveau rectangle géographique non valide.

QGeoRectangle::QGeoRectangle(const QGeoShape &other)

Crée un rectangle géographique à partir du contenu de other.

QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)

Crée un nouveau rectangle géométrique, de taille minimale, contenant l'ensemble des coordinates.

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)

Crée un nouveau rectangle géographique dont la coordonnée du coin supérieur gauche est topLeft et celle du coin inférieur droit bottomRight.

QGeoRectangle::QGeoRectangle(const QGeoCoordinate &center, double degreesWidth, double degreesHeight)

Crée un nouveau rectangle géographique centré sur center, d'une largeur en degrés de degreesWidth et d'une hauteur en degrés de degreesHeight.

Si la coordonnée degreesHeight fait déborder le rectangle géographique au-delà de l’un des pôles, la hauteur du rectangle géographique sera tronquée de manière à ce que celui-ci ne s’étende que jusqu’au pôle. Le centre du rectangle géographique restera inchangé, et la hauteur sera ajustée de manière à ce que le point central se trouve au centre du rectangle géographique tronqué.

QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)

Crée un rectangle géographique à partir du contenu de other.

[noexcept] QGeoRectangle::~QGeoRectangle()

Supprime ce rectangle géométrique.

QGeoCoordinate QGeoRectangle::bottomLeft() const

Renvoie la coordonnée du coin inférieur gauche de ce rectangle géométrique.

Remarque : fonctiongetter pour la propriété bottomLeft.

Voir aussi : ` setBottomLeft()`.

QGeoCoordinate QGeoRectangle::bottomRight() const

Renvoie la coordonnée du coin inférieur droit de ce rectangle géométrique.

Remarque : fonctiongetter pour la propriété bottomRight.

Voir aussi setBottomRight().

QGeoCoordinate QGeoRectangle::center() const

Renvoie le centre de ce rectangle géométrique. Équivalent à ` QGeoShape::center()`.

Remarque : fonctionde lecture de la propriété center.

Voir également setCenter().

bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const

Indique si le rectangle géographique rectangle est contenu dans ce rectangle géographique.

[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)

Étend le rectangle géographique pour qu'il couvre également la coordonnée coordinate

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

double QGeoRectangle::height() const

Renvoie la hauteur de ce rectangle géographique en degrés.

La valeur renvoyée est indéfinie si ce rectangle géographique n'est pas valide.

Remarque : fonction de lecture (getter ) pour la propriété « height ».

Voir aussi setHeight().

[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const

Indique si le rectangle géographique rectangle coupe ce rectangle géographique.

Si les bords supérieurs ou inférieurs des deux rectangles géographiques se trouvent à l'un des pôles, les rectangles géographiques sont considérés comme se coupant, car la longitude n'a aucune importance lorsque les bords se trouvent au pôle.

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

void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)

Définit la coordonnée inférieure gauche de ce rectangle géométrique sur bottomLeft.

Remarque : fonctionde définition de la propriété bottomLeft.

Voir également bottomLeft().

void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)

Définit la coordonnée inférieure droite de ce rectangle géométrique sur bottomRight.

Remarque : fonctionde définition de la propriété bottomRight.

Voir également bottomRight().

void QGeoRectangle::setCenter(const QGeoCoordinate &center)

Définit le centre de ce rectangle géométrique à l'adresse center.

Si cela entraîne un chevauchement du rectangle géométrique avec l'un des pôles, la hauteur du rectangle géométrique sera tronquée de manière à ce que celui-ci ne s'étende que jusqu'au pôle. Le centre du rectangle géométrique restera inchangé, et la hauteur sera ajustée de sorte que le point central se trouve au centre du rectangle géométrique tronqué.

Remarque : fonctionde définition de la propriété center.

Voir également center().

void QGeoRectangle::setHeight(double degreesHeight)

Définit la hauteur de ce rectangle géométrique en degrés à degreesHeight.

Remarque : fonctionde définition de la propriété height.

Voir également height().

void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)

Définit la coordonnée supérieure gauche de ce rectangle géométrique sur topLeft.

Remarque : fonctionde définition de la propriété topLeft.

Voir également topLeft().

void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)

Définit la coordonnée supérieure droite de ce rectangle géométrique sur topRight.

Remarque : fonctionde définition de la propriété topRight.

Voir aussi ` topRight()`.

void QGeoRectangle::setWidth(double degreesWidth)

Définit la largeur de ce rectangle géométrique en degrés à degreesWidth.

Remarque : fonctionde définition de la propriété width.

Voir également width().

[invokable] QString QGeoRectangle::toString() const

Renvoie les propriétés du rectangle géographique sous forme de chaîne de caractères.

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

QGeoCoordinate QGeoRectangle::topLeft() const

Renvoie la coordonnée du coin supérieur gauche de ce rectangle géographique.

Remarque : fonctionde lecture pour la propriété topLeft.

Voir aussi setTopLeft().

QGeoCoordinate QGeoRectangle::topRight() const

Renvoie la coordonnée du coin supérieur droit de ce rectangle géographique.

Remarque : fonctionde récupération de la propriété topRight.

Voir également setTopRight().

[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)

Translate ce rectangle géographique de degreesLatitude vers le nord et de degreesLongitude vers l'est.

Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à un décalage vers le sud et vers l'ouest.

Si le décalage devait amener le rectangle géographique à traverser un pôle, celui-ci sera décalé jusqu’à ce que son bord supérieur ou inférieur touche le pôle, sans aller plus loin.

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

[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const

Renvoie une copie de ce rectangle géographique translaté selon les coordonnées degreesLatitude vers le nord et degreesLongitude vers l'est.

Des valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à un décalage vers le sud et vers l'ouest.

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

Voir également translate().

[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const

Renvoie le plus petit rectangle géographique contenant à la fois ce rectangle géographique et rectangle.

Si les centres des deux rectangles géographiques sont séparés exactement de 180,0 degrés, la largeur est alors fixée à 360,0 degrés, la longitude la plus à gauche étant fixée à -180,0 degrés et la longitude la plus à droite à 180,0 degrés. Cette mesure vise à garantir que le résultat ne dépend pas de l’ordre des opérandes.

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

double QGeoRectangle::width() const

Renvoie la largeur de ce rectangle géographique en degrés.

La valeur renvoyée est indéfinie si ce rectangle géographique n'est pas valide.

Remarque : fonctiongetter pour la propriété width.

Voir aussi setWidth().

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

Attribue la fonction « other » à ce rectangle géographique et renvoie une référence à ce rectangle géographique.

QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const

Renvoie le plus petit rectangle géographique contenant à la fois ce rectangle géographique et rectangle.

Si les centres des deux rectangles géographiques sont séparés exactement de 180,0 degrés, la largeur est alors fixée à 360,0 degrés, la longitude la plus à gauche étant fixée à -180,0 degrés et la longitude la plus à droite à 180,0 degrés. Cette procédure permet de garantir que le résultat ne dépend pas de l'ordre des opérandes.

QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)

Renvoie le plus petit rectangle géographique contenant à la fois ce rectangle géographique et rectangle.

Si les centres des deux rectangles géographiques sont séparés exactement de 180,0 degrés, la largeur est alors fixée à 360,0 degrés, la longitude la plus à gauche étant fixée à -180,0 degrés et la longitude la plus à droite à 180,0 degrés. Cette procédure permet de garantir que le résultat ne dépend pas de l'ordre des opérandes.

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