QGeoLocation Class
Die Klasse „QGeoLocation“ stellt grundlegende Informationen zu einem Standort dar. Mehr...
| Header: | #include <QGeoLocation> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
Öffentliche Funktionen
| QGeoLocation() | |
| QGeoLocation(const QGeoLocation &other) | |
(since 6.2) | QGeoLocation(QGeoLocation &&other) |
| ~QGeoLocation() | |
| QGeoAddress | address() const |
(since 6.2) QGeoShape | boundingShape() const |
| QGeoCoordinate | coordinate() const |
| QVariantMap | extendedAttributes() const |
| bool | isEmpty() const |
| void | setAddress(const QGeoAddress &address) |
(since 6.2) void | setBoundingShape(const QGeoShape &boundingShape) |
| void | setCoordinate(const QGeoCoordinate &coordinate) |
| void | setExtendedAttributes(const QVariantMap &data) |
(since 6.2) void | swap(QGeoLocation &other) |
(since 6.2) QGeoLocation & | operator=(QGeoLocation &&other) |
| QGeoLocation & | operator=(const QGeoLocation &other) |
Zugehörige Nicht-Mitglieder
| size_t | qHash(const QGeoLocation &location, size_t seed = 0) |
| bool | operator!=(const QGeoLocation &lhs, const QGeoLocation &rhs) |
| bool | operator==(const QGeoLocation &lhs, const QGeoLocation &rhs) |
Ausführliche Beschreibung
Ein QGeoLocation besteht aus einer Koordinate und der entsprechenden Adresse sowie einer optionalen Begrenzungsform, bei der es sich um den empfohlenen Bereich handelt, der bei der Anzeige des Standorts dargestellt werden soll.
Dokumentation der Member-Funktionen
QGeoLocation::QGeoLocation()
Erstellt ein neues Standortobjekt.
QGeoLocation::QGeoLocation(const QGeoLocation &other)
Erstellt eine Kopie von other
[constexpr noexcept default, since 6.2] QGeoLocation::QGeoLocation(QGeoLocation &&other)
Erstellt ein Geolokalisierungsobjekt, indem es von other verschoben wird.
Hinweis: Das von dort übernommene QGeoLocation-Objekt kann nur zerstört oder einer Variablen zugewiesen werden. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept] QGeoLocation::~QGeoLocation()
Löscht das Standortobjekt.
QGeoAddress QGeoLocation::address() const
Gibt die Adresse des Speicherorts zurück.
Siehe auch „ setAddress()“.
[since 6.2] QGeoShape QGeoLocation::boundingShape() const
Gibt eine Begrenzungsform zurück, die den empfohlenen Bereich darstellt, der bei der Anzeige dieses Standorts angezeigt werden soll.
Beispielsweise kann der Standort eines Gebäudes einen Bereich umfassen, der um das Gebäude herum zentriert ist, wobei dieser Bereich jedoch groß genug ist, um den unmittelbaren geografischen Kontext darzustellen.
Hinweis: Diese Methode wurde in Qt 6 als Ersatz für die Methode `boundingBox()` eingeführt. Sie gibt ein ` QGeoShape ` anstelle eines ` QGeoRectangle` zurück. Verwenden Sie ` QGeoShape::boundingGeoRectangle()`, um ein Begrenzungs QGeoRectangle für die Form zu erhalten.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch ` setBoundingShape()`.
QGeoCoordinate QGeoLocation::coordinate() const
Gibt die Koordinate des Standorts zurück.
Siehe auch „ setCoordinate()“.
QVariantMap QGeoLocation::extendedAttributes() const
Gibt die diesem Speicherort zugeordneten erweiterten Attribute zurück. Erweiterte Attribute sind backendabhängig und können ortsabhängig sein.
Siehe auch ` setExtendedAttributes()`.
bool QGeoLocation::isEmpty() const
Gibt „ true “ zurück, wenn die Standortkoordinate „ invalid “ lautet und alle anderen Standortfelder leer sind. Andernfalls wird „ false “ zurückgegeben.
void QGeoLocation::setAddress(const QGeoAddress &address)
Legt die „ address “ des Standorts fest.
Siehe auch „ address()“.
[since 6.2] void QGeoLocation::setBoundingShape(const QGeoShape &boundingShape)
Legt den „ boundingShape “ des Standorts fest.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch „ boundingShape()“.
void QGeoLocation::setCoordinate(const QGeoCoordinate &coordinate)
Legt die „ coordinate “ des Standorts fest.
Siehe auch coordinate().
void QGeoLocation::setExtendedAttributes(const QVariantMap &data)
Legt die erweiterten Attribute des Speicherorts mit den unter data angegebenen Parametern fest.
Siehe auch extendedAttributes().
[noexcept, since 6.2] void QGeoLocation::swap(QGeoLocation &other)
Tauscht diesen Speicherort mit „ other “ aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
[noexcept, since 6.2] QGeoLocation &QGeoLocation::operator=(QGeoLocation &&other)
Verschiebt „ other “ an diesen Speicherort und gibt eine Referenz auf diesen Speicherort zurück.
Hinweis: Das Objekt „ QGeoLocation “, von dem die Zuweisung stammt, kann nur zerstört oder einer Zuweisung unterzogen werden. Die Auswirkungen des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren sind undefiniert.
Diese Funktion wurde in Qt 6.2 eingeführt.
QGeoLocation &QGeoLocation::operator=(const QGeoLocation &other)
Weist diesem Speicherort „ other “ zu und gibt eine Referenz auf diesen Speicherort zurück.
Verwandte Nicht-Mitglieder
[noexcept] size_t qHash(const QGeoLocation &location, size_t seed = 0)
Gibt den Hash-Wert für das Objekt „ location “ zurück, wobei „ seed “ für die Berechnung verwendet wird.
Hinweis: Der Hash-Wert berücksichtigt keine erweiterten Attribute. Das bedeutet, dass zwei Geolokalisierungsobjekte, die sich nur in den erweiterten Attributen unterscheiden, ähnliche Hash-Werte liefern.
bool operator!=(const QGeoLocation &lhs, const QGeoLocation &rhs)
Gibt „ true “ zurück, wenn die Adresse „ lhs “ nicht mit „ rhs “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
bool operator==(const QGeoLocation &lhs, const QGeoLocation &rhs)
Gibt „ true “ zurück, wenn die Adresse „ lhs “ mit „ rhs “ übereinstimmt, andernfalls „ false “.
© 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.
