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 ¢er, 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 ¢er) |
| 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 :
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 :
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 :
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 ¢er, 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 ¢er)
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.