QGeoRectangle Class
Die Klasse „QGeoRectangle“ definiert ein rechteckiges geografisches Gebiet. Mehr...
| Header: | #include <QGeoRectangle> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
| Erbt von: | QGeoShape |
Eigenschaften
|
Öffentliche Funktionen
| 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) |
Ausführliche Beschreibung
Das Rechteck wird durch eine Koordinate „ QGeoCoordinate “ definiert, die die Koordinate der oberen linken Ecke des Rechtecks angibt, sowie durch eine Koordinate „ QGeoCoordinate “, die die Koordinate der unteren rechten Ecke des Rechtecks angibt.
Ein Geo-Rechteck gilt als ungültig, wenn die Koordinaten der oberen linken oder unteren rechten Ecke ungültig sind oder wenn die Koordinate der oberen linken Ecke südlicher liegt als die der unteren rechten Ecke.
Geo-Rechtecke dürfen niemals die Pole kreuzen.
Mehrere Methoden verhalten sich so, als ob das Geo-Rechteck anhand einer Mittelpunktskoordinate, der Breite des Geo-Rechtecks in Grad und der Höhe des Geo-Rechtecks in Grad definiert wäre.
Wenn die Höhe oder der Mittelpunkt eines Geo-Rechtecks so angepasst wird, dass es einen der Pole überqueren würde, wird die Höhe so geändert, dass das Geo-Rechteck den Pol berührt, ihn aber nicht überquert, und dass sich die Mittelpunktskoordinate weiterhin in der Mitte des Geo-Rechtecks befindet.
Diese Klasse ist in QML auch unter „ geoRectangle “ verfügbar.
Dokumentation der Eigenschaften
bottomLeft : QGeoCoordinate
Diese Eigenschaft enthält die Koordinate der unteren linken Ecke dieses Geo-Rechtecks.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen gibt es jedoch bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
| QGeoCoordinate | bottomLeft() const |
| void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
Diese Eigenschaft enthält die Koordinate der unteren rechten Ecke dieses Geo-Rechtecks.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen sind jedoch bereits seit der ersten Version dieser Klasse vorhanden.
Zugriffsfunktionen:
| QGeoCoordinate | bottomRight() const |
| void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
Diese Eigenschaft enthält den Mittelpunkt dieses Geo-Rechtecks.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen sind jedoch bereits seit der ersten Version dieser Klasse vorhanden.
Zugriffsfunktionen:
Siehe auch „ QGeoShape::center “.
height : double
Diese Eigenschaft enthält die Höhe dieses Geo-Rechtecks in Grad.
Der Eigenschaftswert ist undefiniert, wenn dieses Geo-Rechteck ungültig ist.
Wenn die neue Höhe kleiner als 0,0 ist oder wenn dieses Geo-Rechteck ungültig ist, wird die Eigenschaft nicht geändert. Um die Werte eines ungültigen Geo-Rechtecks basierend auf Mittelpunkt, Breite und Höhe festzulegen, sollten Sie zunächst setCenter() verwenden, um das Geo-Rechteck gültig zu machen.
Sollte die Änderung der Höhe dazu führen, dass das Geo-Rechteck einen Pol schneidet, wird die Höhe so angepasst, dass das Geo-Rechteck den Pol lediglich berührt.
Diese Anpassung erfolgt so, dass die Mittelpunktskoordinate weiterhin im Mittelpunkt des Geo-Rechtecks liegt, was dazu führen kann, dass das Geo-Rechteck eine geringere Höhe als erwartet aufweist.
180,0 ist die Höhe, die nur dann verwendet wird, wenn die neue Höhe größer oder gleich 180 ist.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen existieren jedoch bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
topLeft : QGeoCoordinate
Diese Eigenschaft enthält die Koordinate der oberen linken Ecke dieses Geo-Rechtecks.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen gibt es jedoch bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
| QGeoCoordinate | topLeft() const |
| void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
Diese Eigenschaft enthält die Koordinate der oberen rechten Ecke dieses Geo-Rechtecks.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen existieren jedoch bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
| QGeoCoordinate | topRight() const |
| void | setTopRight(const QGeoCoordinate &topRight) |
width : double
Diese Eigenschaft enthält die Breite dieses Geo-Rechtecks in Grad.
Der Eigenschaftswert ist undefiniert, wenn dieses Geo-Rechteck ungültig ist.
Wenn die neue Breite kleiner als 0,0 ist oder wenn dieses Geo-Rechteck ungültig ist, führt diese Funktion keine Aktion aus. Um die Werte eines ungültigen Geo-Rechtecks basierend auf Mittelpunkt, Breite und Höhe festzulegen, sollten Sie zunächst die Funktion „ setCenter()“ verwenden, um das Geo-Rechteck gültig zu machen.
360,0 wird nur dann als Breite verwendet, wenn die neue Breite größer oder gleich 360 ist. In solchen Fällen wird der östlichste Längengrad des Geo-Rechtecks auf -180,0 Grad und der westlichste Längengrad des Geo-Rechtecks auf 180,0 Grad gesetzt.
Diese Eigenschaft wurde zwar erst in Qt 5.5 eingeführt, die zugehörigen Zugriffsfunktionen existieren jedoch bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
Dokumentation zu den Mitgliedsfunktionen
QGeoRectangle::QGeoRectangle()
Erstellt ein neues, ungültiges Geo-Rechteck.
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
Erstellt ein Geo-Rechteck aus dem Inhalt von other.
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
Erstellt ein neues Geo-Rechteck mit minimaler Größe, das den gesamten Bereich coordinates umfasst.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
Erstellt ein neues Geo-Rechteck mit der Koordinate topLeft in der oberen linken Ecke und der Koordinate bottomRight in der unteren rechten Ecke.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
Erstellt ein neues Geo-Rechteck, dessen Mittelpunkt bei center liegt, dessen Breite in Grad degreesWidth beträgt und dessen Höhe in Grad degreesHeight beträgt.
Sollte degreesHeight dazu führen, dass das Geo-Rechteck über einen der Pole hinausragt, wird die Höhe des Geo-Rechtecks so gekürzt, dass sich das Geo-Rechteck nur bis zum Pol erstreckt. Der Mittelpunkt des Geo-Rechtecks bleibt unverändert, und die Höhe wird so angepasst, dass der Mittelpunkt im Zentrum des gekürzten Geo-Rechtecks liegt.
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
Erstellt ein Geo-Rechteck aus dem Inhalt von other.
[noexcept] QGeoRectangle::~QGeoRectangle()
Löscht dieses Geo-Rechteck.
QGeoCoordinate QGeoRectangle::bottomLeft() const
Gibt die Koordinate der unteren linken Ecke dieses Geo-Rechtecks zurück.
Hinweis: Getter -Funktion für die Eigenschaft „bottomLeft“.
Siehe auch „ setBottomLeft()“.
QGeoCoordinate QGeoRectangle::bottomRight() const
Gibt die Koordinate der unteren rechten Ecke dieses Geo-Rechtecks zurück.
Hinweis: Getter -Funktion für die Eigenschaft „bottomRight“.
Siehe auch „ setBottomRight()“.
QGeoCoordinate QGeoRectangle::center() const
Gibt den Mittelpunkt dieses Geo-Rechtecks zurück. Entspricht ` QGeoShape::center()`.
Hinweis: Getter -Funktion für die Eigenschaft „center“.
Siehe auch „ setCenter()“.
bool QGeoRectangle::contains(const QGeoRectangle &rectangle) const
Gibt zurück, ob das Geo-Rechteck rectangle innerhalb dieses Geo-Rechtecks liegt.
[invokable] void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
Erweitert das Geo-Rechteck so, dass es auch die Koordinate abdeckt coordinate
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
double QGeoRectangle::height() const
Gibt die Höhe dieses Geo-Rechtecks in Grad zurück.
Der Rückgabewert ist undefiniert, wenn dieses Geo-Rechteck ungültig ist.
Hinweis: Getter -Funktion für die Eigenschaft „height“.
Siehe auch „ setHeight()“.
[invokable] bool QGeoRectangle::intersects(const QGeoRectangle &rectangle) const
Gibt zurück, ob das Geo-Rechteck rectangle dieses Geo-Rechteck schneidet.
Befinden sich die oberen oder unteren Kanten beider Geo-Rechtecke an einem der Pole, gelten die Geo-Rechtecke als sich überschneidend, da der Längengrad irrelevant ist, wenn sich die Kanten am Pol befinden.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
Setzt die Koordinate der unteren linken Ecke dieses Geo-Rechtecks auf bottomLeft.
Hinweis: Setter -Funktion für die Eigenschaft „ bottomLeft “.
Siehe auch ` bottomLeft()`.
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
Setzt die Koordinate der unteren rechten Ecke dieses Geo-Rechtecks auf bottomRight.
Hinweis: Setter -Funktion für die Eigenschaft „ bottomRight “.
Siehe auch „ bottomRight()“.
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
Setzt den Mittelpunkt dieses Geo-Rechtecks auf center.
Wenn das Geo-Rechteck dadurch einen der Pole schneidet, wird die Höhe des Geo-Rechtecks so gekürzt, dass sich das Geo-Rechteck nur bis zum Pol erstreckt. Der Mittelpunkt des Geo-Rechtecks bleibt unverändert, und die Höhe wird so angepasst, dass der Mittelpunkt in der Mitte des gekürzten Geo-Rechtecks liegt.
Hinweis: Setter -Funktion für die Eigenschaft center.
Siehe auch ` center()`.
void QGeoRectangle::setHeight(double degreesHeight)
Legt die Höhe dieses Geo-Rechtecks in Grad auf „ degreesHeight “ fest.
Hinweis: Setter -Funktion für die Eigenschaft „ height “.
Siehe auch „ height()“.
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
Setzt die Koordinate der oberen linken Ecke dieses Geo-Rechtecks auf „ topLeft “.
Hinweis: Setter -Funktion für die Eigenschaft ` topLeft`.
Siehe auch „ topLeft()“.
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
Setzt die Koordinate der oberen rechten Ecke dieses Geo-Rechtecks auf topRight.
Hinweis: Setter -Funktion für die Eigenschaft „ topRight “.
Siehe auch ` topRight()`.
void QGeoRectangle::setWidth(double degreesWidth)
Legt die Breite dieses Geo-Rechtecks in Grad auf degreesWidth fest.
Hinweis: Setter -Funktion für die Eigenschaft „ width “.
Siehe auch „ width()“.
[invokable] QString QGeoRectangle::toString() const
Gibt die Eigenschaften des Geo-Rechtecks als Zeichenkette zurück.
Hinweis: Diese Funktion kann über das Metaobjekt-System und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
QGeoCoordinate QGeoRectangle::topLeft() const
Gibt die Koordinate der oberen linken Ecke dieses Geo-Rechtecks zurück.
Hinweis: Getter -Funktion für die Eigenschaft „topLeft“.
Siehe auch „ setTopLeft()“.
QGeoCoordinate QGeoRectangle::topRight() const
Gibt die Koordinate der oberen rechten Ecke dieses Geo-Rechtecks zurück.
Hinweis: Getter -Funktion für die Eigenschaft „topRight“.
Siehe auch „ setTopRight()“.
[invokable] void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
Verschiebt dieses Geo-Rechteck um degreesLatitude nach Norden und um degreesLongitude nach Osten.
Negative Werte für degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hätte die Verschiebung dazu geführt, dass das Geo-Rechteck einen Pol überquert, wird das Geo-Rechteck so lange verschoben, bis die obere oder untere Kante des Geo-Rechtecks den Pol berührt, jedoch nicht darüber hinaus.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
[invokable] QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geo-Rechtecks zurück, das um degreesLatitude nach Norden und um degreesLongitude nach Osten verschoben wurde.
Negative Werte für degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch translate().
[invokable] QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
Gibt das kleinste Geo-Rechteck zurück, das sowohl dieses Geo-Rechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Geo-Rechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad festgelegt, wobei der östlichste Längengrad auf -180,0 Grad und der westlichste Längengrad auf 180,0 Grad gesetzt wird. Dies geschieht, um sicherzustellen, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
Hinweis: Diese Funktion kann über das Metaobjektsystem und aus QML aufgerufen werden. Siehe Q_INVOKABLE.
double QGeoRectangle::width() const
Gibt die Breite dieses Geo-Rechtecks in Grad zurück.
Der Rückgabewert ist undefiniert, wenn dieses Geo-Rechteck ungültig ist.
Hinweis: Getter -Funktion für die Eigenschaft „width“.
Siehe auch „ setWidth()“.
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
Weist diesem Geo-Rechteck „ other “ zu und gibt eine Referenz auf dieses Geo-Rechteck zurück.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
Gibt das kleinste Geo-Rechteck zurück, das sowohl dieses Geo-Rechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Geo-Rechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad festgelegt, wobei der Längengrad ganz links auf -180,0 Grad und der Längengrad ganz rechts auf 180,0 Grad gesetzt wird. Dies geschieht, um sicherzustellen, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
Gibt das kleinste Geo-Rechteck zurück, das sowohl dieses Geo-Rechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Geo-Rechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad festgelegt, wobei der östlichste Längengrad auf -180,0 Grad und der westlichste Längengrad auf 180,0 Grad gesetzt wird. Dies geschieht, um sicherzustellen, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
© 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.
