QGeoRectangle Class
Die Klasse QGeoRectangle definiert ein rechteckiges geographisches Gebiet. Mehr...
Kopfzeile: | #include <QGeoRectangle> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
qmake: | QT += positioning |
Vererbungen: | 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) |
Detaillierte Beschreibung
Das Rechteck wird durch eine QGeoCoordinate, die die obere linke Koordinate des Rechtecks angibt, und eine QGeoCoordinate, die die untere rechte Koordinate des Rechtecks angibt, definiert.
Ein Georechteck gilt als ungültig, wenn die Koordinaten oben links oder unten rechts ungültig sind oder wenn die Koordinate oben links südlich der Koordinate unten rechts liegt.
Georechtecke können niemals die Pole kreuzen.
Mehrere Methoden verhalten sich so, als ob das Georechteck durch eine Mittelpunktskoordinate, die Breite des Georechtecks in Grad und die Höhe des Georechtecks in Grad definiert wäre.
Wenn die Höhe oder der Mittelpunkt eines Georechtecks so angepasst wird, dass es einen der Pole überqueren würde, wird die Höhe so geändert, dass das Georechteck den Pol berührt, aber nicht überquert, und dass die Mittelpunktskoordinate immer noch in der Mitte des Georechtecks liegt.
Diese Klasse ist eine Q_GADGET seit Qt 5.5. Sie kann direkt aus C++ und QML verwendet werden.
Dokumentation der Eigenschaften
bottomLeft : QGeoCoordinate
Diese Eigenschaft enthält die untere linke Koorindate dieses Georechtecks.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
QGeoCoordinate | bottomLeft() const |
void | setBottomLeft(const QGeoCoordinate &bottomLeft) |
bottomRight : QGeoCoordinate
Diese Eigenschaft enthält die untere rechte Koordinate dieses Georechtecks.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
QGeoCoordinate | bottomRight() const |
void | setBottomRight(const QGeoCoordinate &bottomRight) |
center : QGeoCoordinate
Diese Eigenschaft enthält den Mittelpunkt dieses Georechtecks.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
Siehe auch QGeoShape::center.
height : double
Diese Eigenschaft gibt die Höhe des Georechtecks in Grad an.
Der Eigenschaftswert ist undefiniert, wenn das Georechteck ungültig ist.
Ist die neue Höhe kleiner als 0,0 oder ist das Georechteck ungültig, wird die Eigenschaft nicht geändert. Um die Werte eines ungültigen Georechtecks auf der Grundlage von Mittelpunkt, Breite und Höhe festzulegen, sollten Sie zunächst setCenter() verwenden, um das Georechteck gültig zu machen.
Wenn die Änderung der Höhe dazu führen würde, dass das Georechteck einen Pol überquert, wird die Höhe so angepasst, dass das Georechteck nur den Pol berührt.
Diese Änderung wird so vorgenommen, dass die Mittelpunktskoordinate immer noch in der Mitte des Georechtecks liegt, was zu einem Georechteck mit einer geringeren Höhe als erwartet führen kann.
180.0 ist die Höhe, die nur verwendet wird, wenn die neue Höhe größer oder gleich 180 ist.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
topLeft : QGeoCoordinate
Diese Eigenschaft enthält die obere linke Koordinate dieses Georechtecks.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
QGeoCoordinate | topLeft() const |
void | setTopLeft(const QGeoCoordinate &topLeft) |
topRight : QGeoCoordinate
Diese Eigenschaft enthält die obere rechte Koordinate dieses Georechtecks.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
QGeoCoordinate | topRight() const |
void | setTopRight(const QGeoCoordinate &topRight) |
width : double
Diese Eigenschaft gibt die Breite des Georechtecks in Grad an.
Der Eigenschaftswert ist undefiniert, wenn das Georechteck ungültig ist.
Ist die neue Breite kleiner als 0.0 oder ist das Georechteck ungültig, so führt diese Funktion nichts aus. Um die Werte eines ungültigen Georechtecks auf der Grundlage von Mittelpunkt, Breite und Höhe festzulegen, sollten Sie zunächst setCenter() verwenden, um das Georechteck gültig zu machen.
360.0 ist die Breite, die nur verwendet wird, wenn die neue Breite gleich oder größer als 360 ist. In solchen Fällen wird die äußerste linke Länge des Geo-Rechtecks auf -180,0 Grad und die äußerste rechte Länge des Geo-Rechtecks auf 180,0 Grad gesetzt.
Während diese Eigenschaft in Qt 5.5 eingeführt wurde, existieren die zugehörigen Accessor-Funktionen bereits seit der ersten Version dieser Klasse.
Zugriffsfunktionen:
Dokumentation der Mitgliedsfunktionen
QGeoRectangle::QGeoRectangle()
Konstruiert ein neues, ungültiges Georechteck.
QGeoRectangle::QGeoRectangle(const QGeoShape &other)
Konstruiert ein Georechteck aus dem Inhalt von other.
QGeoRectangle::QGeoRectangle(const QList<QGeoCoordinate> &coordinates)
Konstruiert ein neues Georechteck mit minimaler Größe, das alle coordinates enthält.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate &topLeft, const QGeoCoordinate &bottomRight)
Konstruiert ein neues Georechteck mit einer linken oberen Koordinate topLeft und einer rechten unteren Koordinate bottomRight.
QGeoRectangle::QGeoRectangle(const QGeoCoordinate ¢er, double degreesWidth, double degreesHeight)
Konstruiert ein neues Geo-Rechteck mit dem Mittelpunkt center mit einer Breite in Grad von degreesWidth und einer Höhe in Grad von degreesHeight.
Wenn degreesHeight das Geo-Rechteck über einen der Pole hinausführen würde, wird die Höhe des Geo-Rechtecks abgeschnitten, so dass das Geo-Rechteck nur bis zu diesem Pol reicht. Der Mittelpunkt des Georechtecks bleibt unverändert, und die Höhe wird so angepasst, dass der Mittelpunkt im Mittelpunkt des abgeschnittenen Georechtecks liegt.
QGeoRectangle::QGeoRectangle(const QGeoRectangle &other)
Konstruiert ein Georechteck aus dem Inhalt von other.
[noexcept]
QGeoRectangle::~QGeoRectangle()
Zerstört dieses Georechteck.
QGeoCoordinate QGeoRectangle::bottomLeft() const
Liefert die untere linke Koordinate dieses Georechtecks.
Hinweis: Getter-Funktion für die Eigenschaft bottomLeft.
Siehe auch setBottomLeft().
QGeoCoordinate QGeoRectangle::bottomRight() const
Gibt die untere rechte Koordinate dieses Georechtecks zurück.
Hinweis: Getter-Funktion für die Eigenschaft bottomRight.
Siehe auch setBottomRight().
QGeoCoordinate QGeoRectangle::center() const
Gibt den Mittelpunkt dieses Georechtecks zurück. Äquivalent zu 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 Georechteck rectangle in diesem Georechteck enthalten ist.
[invokable]
void QGeoRectangle::extendRectangle(const QGeoCoordinate &coordinate)
Erweitert das Georechteck um die Koordinate coordinate
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
double QGeoRectangle::height() const
Gibt die Höhe dieses Georechtecks in Grad zurück.
Der Rückgabewert ist undefiniert, wenn das Georechteck 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 Georechteck rectangle dieses Georechteck schneidet.
Wenn die obere oder untere Kante beider Georechtecke auf einem der Pole liegt, werden die Georechtecke als sich schneidend betrachtet, da der Längengrad irrelevant ist, wenn die Kanten auf dem Pol liegen.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
void QGeoRectangle::setBottomLeft(const QGeoCoordinate &bottomLeft)
Setzt die untere linke Koordinate dieses Georechtecks auf bottomLeft.
Hinweis: Setter-Funktion für die Eigenschaft bottomLeft.
Siehe auch bottomLeft().
void QGeoRectangle::setBottomRight(const QGeoCoordinate &bottomRight)
Setzt die untere rechte Koordinate dieses Georechtecks auf bottomRight.
Hinweis: Setter-Funktion für die Eigenschaft bottomRight.
Siehe auch bottomRight().
void QGeoRectangle::setCenter(const QGeoCoordinate ¢er)
Setzt den Mittelpunkt dieses Georechtecks auf center.
Wenn dies dazu führt, dass das Geo-Rechteck einen der Pole kreuzt, wird die Höhe des Geo-Rechtecks so abgeschnitten, dass das Geo-Rechteck nur bis zu dem Pol reicht. Der Mittelpunkt des Georechtecks bleibt unverändert, und die Höhe wird so angepasst, dass der Mittelpunkt in der Mitte des abgeschnittenen Georechtecks liegt.
Hinweis: Setter-Funktion für die Eigenschaft center.
Siehe auch center().
void QGeoRectangle::setHeight(double degreesHeight)
Setzt die Höhe dieses Georechtecks in Grad auf degreesHeight.
Hinweis: Setter-Funktion für die Eigenschaft height.
Siehe auch height().
void QGeoRectangle::setTopLeft(const QGeoCoordinate &topLeft)
Setzt die obere linke Koordinate dieses Georechtecks auf topLeft.
Hinweis: Setter-Funktion für die Eigenschaft topLeft.
Siehe auch topLeft().
void QGeoRectangle::setTopRight(const QGeoCoordinate &topRight)
Setzt die obere rechte Koordinate dieses Georechtecks auf topRight.
Hinweis: Setter-Funktion für die Eigenschaft topRight.
Siehe auch topRight().
void QGeoRectangle::setWidth(double degreesWidth)
Setzt die Breite dieses Georechtecks in Grad auf degreesWidth.
Hinweis: Setter-Funktion für die Eigenschaft width.
Siehe auch width().
[invokable]
QString QGeoRectangle::toString() const
Gibt die Eigenschaften des Georechtecks als String zurück.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
QGeoCoordinate QGeoRectangle::topLeft() const
Liefert die obere linke Koordinate dieses Georechtecks.
Hinweis: Getter-Funktion für die Eigenschaft topLeft.
Siehe auch setTopLeft().
QGeoCoordinate QGeoRectangle::topRight() const
Gibt die obere rechte Koordinate dieses Georechtecks zurück.
Hinweis: Getter-Funktion für die Eigenschaft topRight.
Siehe auch setTopRight().
[invokable]
void QGeoRectangle::translate(double degreesLatitude, double degreesLongitude)
Verschiebt dieses Georechteck um degreesLatitude nach Norden und degreesLongitude nach Osten.
Negative Werte von degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Wenn die Verschiebung dazu führen würde, dass das Georechteck einen Pol überquert, wird das Georechteck so lange verschoben, bis die Ober- oder Unterkante des Georechtecks den Pol berührt, aber nicht weiter.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
[invokable]
QGeoRectangle QGeoRectangle::translated(double degreesLatitude, double degreesLongitude) const
Gibt eine Kopie dieses Geo-Rechtecks zurück, die um degreesLatitude nach Norden und degreesLongitude nach Osten verschoben wurde.
Negative Werte von degreesLatitude und degreesLongitude entsprechen einer Verschiebung nach Süden bzw. nach Westen.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
Siehe auch translate().
[invokable]
QGeoRectangle QGeoRectangle::united(const QGeoRectangle &rectangle) const
Liefert das kleinste Georechteck, das sowohl dieses Georechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Georechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad gesetzt, wobei der äußerste linke Längengrad auf -180,0 Grad und der äußerste rechte Längengrad auf 180,0 Grad gesetzt wird. Damit wird sichergestellt, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
Hinweis: Diese Funktion kann über das Meta-Objektsystem und von QML aus aufgerufen werden. Siehe Q_INVOKABLE.
double QGeoRectangle::width() const
Gibt die Breite dieses Georechtecks in Grad zurück.
Der Rückgabewert ist undefiniert, wenn das Georechteck ungültig ist.
Hinweis: Getter-Funktion für die Eigenschaft width.
Siehe auch setWidth().
QGeoRectangle &QGeoRectangle::operator=(const QGeoRectangle &other)
Weist other diesem Georechteck zu und gibt einen Verweis auf dieses Georechteck zurück.
QGeoRectangle QGeoRectangle::operator|(const QGeoRectangle &rectangle) const
Liefert das kleinste Georechteck, das sowohl dieses Georechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Georechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad gesetzt, wobei der äußerste linke Längengrad auf -180,0 Grad und der äußerste rechte Längengrad auf 180,0 Grad gesetzt wird. Auf diese Weise wird sichergestellt, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
QGeoRectangle &QGeoRectangle::operator|=(const QGeoRectangle &rectangle)
Liefert das kleinste Georechteck, das sowohl dieses Georechteck als auch rectangle enthält.
Wenn die Mittelpunkte der beiden Georechtecke genau 180,0 Grad voneinander entfernt sind, wird die Breite auf 360,0 Grad gesetzt, wobei der äußerste linke Längengrad auf -180,0 Grad und der äußerste rechte Längengrad auf 180,0 Grad gesetzt wird. Auf diese Weise wird sichergestellt, dass das Ergebnis unabhängig von der Reihenfolge der Operanden ist.
© 2025 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.