QGeoRectangle Class
La classe QGeoRectangle définit une zone géographique rectangulaire. Plus d'informations...
| En-tête : | #include <QGeoRectangle> |
| CMake : | find_package(Qt6 REQUIRED COMPONENTS Positioning)target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake : | QT += positioning |
| Héritages : | 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 en termes de QGeoCoordinate qui spécifie la coordonnée supérieure gauche du rectangle et de QGeoCoordinate qui spécifie la coordonnée inférieure droite du rectangle.
Un géorectangle est considéré comme invalide si les coordonnées en haut à gauche ou en bas à droite sont invalides ou si la coordonnée en haut à gauche est au sud de la coordonnée en bas à droite.
Les géorectangles ne peuvent jamais traverser les pôles.
Plusieurs méthodes se comportent comme si le géo-rectangle était défini en fonction d'une coordonnée centrale, de la largeur du géo-rectangle en degrés et de la hauteur du géo-rectangle en degrés.
Si la hauteur ou le centre d'un géo-rectangle est ajusté de telle sorte qu'il croise l'un des pôles, la hauteur est modifiée de telle sorte que le géo-rectangle touche le pôle mais ne le croise pas et que la coordonnée centrale soit toujours au centre du géo-rectangle.
Cette classe est également accessible en QML sous la forme geoRectangle.
Documentation sur les propriétés
bottomLeft : QGeoCoordinate
Cette propriété contient la coordonnée en bas à gauche de ce rectangle 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 :
| QGeoCoordinate | bottomLeft() const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
Cette propriété contient la coordonnée inférieure droite de ce géo-rectangle.
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 :
| QGeoCoordinate | bottomRight() const |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
Cette propriété contient le centre de ce rectangle 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 :
Voir aussi QGeoShape::center.
height : double
Cette propriété indique la hauteur du rectangle géographique en degrés.
La valeur de la propriété est indéfinie si le rectangle géographique n'est pas valide.
Si la nouvelle hauteur est inférieure à 0.0 ou si ce rectangle géographique est invalide, 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 setCenter() pour rendre le rectangle géographique valide.
Si la modification de la hauteur entraîne le franchissement d'un poteau par le rectangle géographique, la hauteur est ajustée de manière à ce que le rectangle géographique ne touche que le poteau.
Cette modification est effectuée de manière à ce que la coordonnée centrale soit toujours au centre du géorectangle, ce qui peut donner un géorectangle d'une hauteur inférieure à celle prévue.
180.0 est la hauteur utilisée 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 correspondantes existent depuis la première version de cette classe.
Fonctions d'accès :
topLeft : QGeoCoordinate
Cette propriété contient la coordonnée supérieure gauche de ce géo-rectangle.
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 :
| QGeoCoordinate | topLeft() const |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
Cette propriété contient la coordonnée supérieure droite de ce géo-rectangle.
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 :
| QGeoCoordinate | topRight() const |
| void | setTopRight(const QGeoCoordinate &topRight) |
width : double
Cette propriété indique la largeur du rectangle géographique en degrés.
La valeur de la propriété est indéfinie si le 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 setCenter() pour rendre le rectangle géographique valide.
360.0 est la largeur utilisée uniquement si la nouvelle largeur est égale ou supérieure à 360. Dans ce cas, la longitude la plus à gauche du rectangle géographique est fixée à -180,0 degrés et la longitude la plus à droite du rectangle géographique est fixée à 180,0 degrés.
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 :
Documentation des fonctions membres
QGeoRectangle::QGeoRectangle()
Construit un nouveau rectangle géographique invalide.
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
Construit un rectangle géographique à partir du contenu de other.
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
Construit un nouveau géo-rectangle, de taille minimale, contenant tous les coordinates.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
Construit un nouveau géo-rectangle avec une coordonnée supérieure gauche topLeft et une coordonnée inférieure droite bottomRight.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
Construit un nouveau géo-rectangle centré sur center avec une largeur en degrés de degreesWidth et une hauteur en degrés de degreesHeight.
Si degreesHeight entraîne 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 le rectangle géographique ne s'étende que jusqu'au pôle. Le centre du géorectangle restera inchangé et la hauteur sera ajustée de manière à ce que le point central se trouve au centre du géorectangle tronqué.
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
Construit un rectangle géographique à partir du contenu de other.
[noexcept] QGeoRectangle::~QGeoRectangle()
Détruit ce rectangle géographique.
QGeoCoordinate QGeoRectangle::bottomLeft() const
Renvoie la coordonnée inférieure gauche de ce géo-rectangle.
Note : Fonction d'obtention pour la propriété bottomLeft.
Voir également setBottomLeft().
QGeoCoordinate QGeoRectangle::bottomRight() const
Renvoie la coordonnée inférieure droite de ce géo-rectangle.
Remarque : fonction Getter pour la propriété bottomRight.
Voir également setBottomRight().
QGeoCoordinate QGeoRectangle::center() const
Renvoie le centre de ce rectangle géographique. Équivalent à QGeoShape::center().
Remarque : fonction Getter pour le centre de la propriété.
Voir aussi setCenter().
bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const
Indique si le géorectangle rectangle est contenu dans ce géorectangle.
[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
Étend le rectangle géographique pour qu'il couvre également les coordonnées. coordinate
Note : Cette fonction peut être invoquée via le système de méta-objets et à partir de 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 le rectangle géographique n'est pas valide.
Note : Fonction Getter pour la propriété height.
Voir également setHeight().
[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const
Retourne si le géorectangle rectangle intersecte ce géorectangle.
Si les bords supérieurs ou inférieurs des deux rectangles géographiques sont situés à l'un des pôles, les rectangles géographiques sont considérés comme se recoupant, car la longitude n'a pas d'importance lorsque les bords sont situés au pôle.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
Fixe la coordonnée inférieure gauche de ce rectangle géographique à bottomLeft.
Remarque : fonction de définition de la propriété bottomLeft.
Voir également bottomLeft().
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
Fixe la coordonnée inférieure droite de ce rectangle géographique à bottomRight.
Remarque : fonction de définition de la propriété bottomRight.
Voir également bottomRight().
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
Fixe le centre de ce rectangle géographique à center.
Si le géo-rectangle croise l'un des pôles, la hauteur du géo-rectangle sera tronquée de manière à ce que le géo-rectangle ne s'étende que jusqu'au pôle. Le centre du géorectangle restera inchangé et la hauteur sera ajustée de manière à ce que le point central se trouve au centre du géorectangle tronqué.
Remarque : fonction de définition de la propriété center.
Voir également center().
void QGeoRectangle::setHeight(double degreesHeight)
Fixe la hauteur de ce rectangle géographique en degrés à degreesHeight.
Remarque : fonction de définition de la propriété height.
Voir également height().
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
Fixe la coordonnée supérieure gauche de ce rectangle géographique à topLeft.
Remarque : fonction de définition de la propriété topLeft.
Voir également topLeft().
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
Fixe la coordonnée supérieure droite de ce rectangle géographique à topRight.
Remarque : fonction de définition de la propriété topRight.
Voir également topRight().
void QGeoRectangle::setWidth(double degreesWidth)
Fixe la largeur de ce rectangle géographique en degrés à degreesWidth.
Remarque : fonction de 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 la forme d'une chaîne de caractères.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
QGeoCoordinate QGeoRectangle::topLeft() const
Renvoie la coordonnée supérieure gauche de ce géo-rectangle.
Note : Fonction d'obtention pour la propriété topLeft.
Voir également setTopLeft().
QGeoCoordinate QGeoRectangle::topRight() const
Renvoie la coordonnée supérieure droite de ce géo-rectangle.
Remarque : fonction Getter pour la propriété topRight.
Voir également setTopRight().
[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
Traduit ce géo-rectangle de degreesLatitude vers le nord et de degreesLongitude vers l'est.
Les valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation vers le sud et vers l'ouest.
Si la translation devait amener le rectangle géographique à traverser un pôle, le rectangle géographique sera translaté jusqu'à ce que le bord supérieur ou inférieur du rectangle géographique touche le pôle, mais pas au-delà.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
Renvoie une copie de ce géo-rectangle traduit par degreesLatitude vers le nord et degreesLongitude vers l'est.
Les valeurs négatives de degreesLatitude et degreesLongitude correspondent respectivement à une translation vers le sud et vers l'ouest.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de QML. Voir Q_INVOKABLE.
Voir également translate().
[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
Renvoie le plus petit géo-rectangle qui contient à la fois ce géo-rectangle et rectangle.
Si les centres des deux rectangles géographiques sont séparés par exactement 180,0 degrés, la largeur est 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. Cela permet de s'assurer que le résultat est indépendant de l'ordre des opérandes.
Remarque : cette fonction peut être invoquée via le système de méta-objets et à partir de 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 le rectangle géographique n'est pas valide.
Remarque : fonction d'obtention de la propriété width.
Voir également setWidth().
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
Attribue other à ce géo-rectangle et renvoie une référence à ce géo-rectangle.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
Renvoie le plus petit géo-rectangle qui contient à la fois ce géo-rectangle et rectangle.
Si les centres des deux rectangles géographiques sont séparés par exactement 180,0 degrés, la largeur est 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. Cela permet de s'assurer que le résultat est indépendant de l'ordre des opérandes.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
Renvoie le plus petit géo-rectangle qui contient à la fois ce géo-rectangle et rectangle.
Si les centres des deux rectangles géographiques sont séparés par exactement 180,0 degrés, la largeur est 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. Cela permet de s'assurer que le résultat est indépendant 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.