QGeoAddress Class
Die Klasse „QGeoAddress“ repräsentiert eine Adresse eines „ QGeoLocation “. Mehr...
| Header: | #include <QGeoAddress> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
| qmake: | QT += positioning |
Öffentliche Funktionen
| QGeoAddress() | |
| QGeoAddress(const QGeoAddress &other) | |
(since 6.2) | QGeoAddress(QGeoAddress &&other) |
| ~QGeoAddress() | |
| QString | city() const |
| void | clear() |
| QString | country() const |
| QString | countryCode() const |
| QString | county() const |
| QString | district() const |
| bool | isEmpty() const |
| bool | isTextGenerated() const |
| QString | postalCode() const |
| void | setCity(const QString &city) |
| void | setCountry(const QString &country) |
| void | setCountryCode(const QString &countryCode) |
| void | setCounty(const QString &county) |
| void | setDistrict(const QString &district) |
| void | setPostalCode(const QString &postalCode) |
| void | setState(const QString &state) |
| void | setStreet(const QString &street) |
(since 6.2) void | setStreetNumber(const QString &streetNumber) |
| void | setText(const QString &text) |
| QString | state() const |
| QString | street() const |
(since 6.2) QString | streetNumber() const |
(since 6.2) void | swap(QGeoAddress &other) |
| QString | text() const |
(since 6.2) QGeoAddress & | operator=(QGeoAddress &other) |
| QGeoAddress & | operator=(const QGeoAddress &address) |
Zugehörige Nicht-Mitglieder
| size_t | qHash(const QGeoAddress &address, size_t seed = 0) |
| bool | operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs) |
| bool | operator==(const QGeoAddress &lhs, const QGeoAddress &rhs) |
Detaillierte Beschreibung
Die Attribute der Adresse werden auf US-amerikanische Objektnamen normiert und können den lokalen Objektebenen zugeordnet werden (beispielsweise entspricht „State“ dem „Bundesland“ in Deutschland).
Die Adresse enthält eine „ text “ () zur Anzeige sowie zusätzliche Eigenschaften für den Zugriff auf die Komponenten einer Adresse:
Dokumentation zu Mitgliedsfunktionen
QGeoAddress::QGeoAddress()
Standardkonstruktor.
QGeoAddress::QGeoAddress(const QGeoAddress &other)
Erstellt eine Kopie von „ other “.
[constexpr noexcept default, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)
Erstellt ein Geo-Adressobjekt, indem es von other verschoben wird.
Hinweis: Das aus xml-ph-0000@deepl.internal übernommene QGeoAddress-Objekt kann nur zerstört oder 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] QGeoAddress::~QGeoAddress()
Löscht diese Adresse.
QString QGeoAddress::city() const
Gibt den Namen der Stadt zurück.
Siehe auch ` setCity()`.
void QGeoAddress::clear()
Löscht alle Datenfelder der Adresse.
QString QGeoAddress::country() const
Gibt den Ländernamen zurück.
Siehe auch „ setCountry()“.
QString QGeoAddress::countryCode() const
Gibt den Ländercode gemäß ISO 3166-1 Alpha-3 zurück
Siehe auch setCountryCode().
QString QGeoAddress::county() const
Gibt den Landkreis zurück. Der Landkreis gilt als die zweite Verwaltungsebene unterhalb des Landes.
Siehe auch „ setCounty()“.
QString QGeoAddress::district() const
Gibt den Bezirk zurück. Der Bezirk gilt als die untergeordnete Verwaltungseinheit der Stadt.
Siehe auch „ setDistrict()“.
bool QGeoAddress::isEmpty() const
Gibt zurück, ob diese Adresse leer ist. Eine Adresse gilt als leer, wenn alle ihre Felder leer sind.
bool QGeoAddress::isTextGenerated() const
Gibt „true“ zurück, wenn QGeoAddress::text() automatisch aus Adresselementen generiert wird; andernfalls gibt es „false“ zurück, wenn text() explizit zugewiesen wurde.
Siehe auch ` text()` und ` setText()`.
QString QGeoAddress::postalCode() const
Gibt die Postleitzahl zurück.
Siehe auch „ setPostalCode()“.
void QGeoAddress::setCity(const QString &city)
Legt den Wert „ city “ fest.
Siehe auch city().
void QGeoAddress::setCountry(const QString &country)
Legt den Namen des „ country “ fest.
Siehe auch country().
void QGeoAddress::setCountryCode(const QString &countryCode)
Legt die „ countryCode “ gemäß ISO 3166-1 Alpha-3 fest
Siehe auch „ countryCode“ ().
void QGeoAddress::setCounty(const QString &county)
Legt die „ county “ fest.
Siehe auch county().
void QGeoAddress::setDistrict(const QString &district)
Legt „ district “ fest.
Siehe auch district().
void QGeoAddress::setPostalCode(const QString &postalCode)
Legt die „ postalCode “ fest.
Siehe auch postalCode().
void QGeoAddress::setState(const QString &state)
Legt die „ state “ fest.
Siehe auch state().
void QGeoAddress::setStreet(const QString &street)
Legt den Straßennamen auf „ street “ fest.
Hinweis: Vor Qt6 konnte dieser Wert auch Angaben wie eine Hausnummer, einen Gebäudenamen oder andere Informationen enthalten, die zur Unterscheidung verschiedener Adressen dienen konnten. Verwenden Sie nun „ setStreetNumber()“, um diese Daten festzulegen.
Siehe auch „ street()“ und „ setStreetNumber()“.
[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)
Setzt die Hausnummer auf „ streetNumber “.
Dies kann auch Angaben wie eine Wohnungsnummer, einen Gebäudenamen oder sonstige Informationen enthalten, die zur Unterscheidung verschiedener Adressen dienen können.
Hinweis: Vor Qt 6 wurde diese Information über die Methode ` setStreet()` festgelegt.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch „ streetNumber()“ und „ setStreet()“.
void QGeoAddress::setText(const QString &text)
Wenn „ text “ nicht leer ist, wird „ text “ explizit als die Zeichenfolge zugewiesen, die von „ text()“ zurückgegeben werden soll. „ isTextGenerated()“ gibt „false“ zurück.
Ist ` text ` leer, bedeutet dies, dass ` text()` automatisch aus den Adresselementen generiert werden soll. ` isTextGenerated()` gibt „true“ zurück.
Siehe auch text().
QString QGeoAddress::state() const
Gibt den Bundesstaat zurück. Der Bundesstaat gilt als erste Untergliederung unterhalb der Länderebene.
Siehe auch „ setState()“.
QString QGeoAddress::street() const
Gibt den Straßennamen zurück.
Hinweis: Vor Qt6 konnte dies auch Angaben wie eine Hausnummer, einen Gebäudenamen oder andere Merkmale enthalten, anhand derer sich eine Adresse von einer anderen unterscheiden ließ. Verwenden Sie nun ` streetNumber()` (), um diese Daten abzurufen.
Siehe auch ` setStreet()` und ` streetNumber()`.
[since 6.2] QString QGeoAddress::streetNumber() const
Gibt die Hausnummer zurück.
Diese kann auch Angaben wie eine Wohnungsnummer, einen Gebäudenamen oder sonstige Informationen enthalten, die zur Unterscheidung verschiedener Adressen dienen können.
Hinweis: Vor Qt 6 wurde diese Information von der Methode ` street()` zurückgegeben.
Diese Funktion wurde in Qt 6.2 eingeführt.
Siehe auch ` setStreetNumber()` und ` street()`.
[noexcept, since 6.2] void QGeoAddress::swap(QGeoAddress &other)
Tauscht diese Adresse gegen other aus. Dieser Vorgang ist sehr schnell und schlägt niemals fehl.
Diese Funktion wurde in Qt 6.2 eingeführt.
QString QGeoAddress::text() const
Gibt die Adresse als einzelne formatierte Zeichenkette zurück. Dies ist die empfohlene Zeichenkette, um die Adresse dem Benutzer anzuzeigen. Sie hat in der Regel das Format einer Adresse, wie sie auf einem Briefumschlag zu finden ist, was jedoch nicht immer der Fall sein muss.
Der Adresstext wird entweder automatisch generiert oder explizit zugewiesen. Dies lässt sich durch Abfrage von ` isTextGenerated` feststellen.
Wird bei ` setText()` eine leere Zeichenkette übergeben, wird ` isTextGenerated()` auf ` true ` gesetzt und `text()` gibt eine Zeichenkette zurück, die lokal gemäß ` countryCode()` und basierend auf den Adresselementen wie Straße, Ort usw. formatiert ist. Da die Textzeichenfolge aus den Adresselementen generiert wird, kann eine Abfolge von Aufrufen wie text(), setStreet() und text() bei jedem Aufruf von text() unterschiedliche Zeichenfolgen zurückgeben.
Wird „ setText()“ eine nicht leere Zeichenkette übergeben, wird „ isTextGenerated()“ auf „ false “ gesetzt und „text()“ gibt stets die explizit zugewiesene Zeichenkette zurück. Aufrufe zur Änderung anderer Elemente wie „ setStreet()“, „ setCity()“ usw. haben keinen Einfluss auf die von „text()“ zurückgegebene Zeichenkette.
Siehe auch setText().
[implicit, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)
Die Funktion „move“ weist das Objekt „ other “ dieser Adresse zu und gibt einen Verweis auf diese Adresse zurück.
Hinweis: Das Objekt „ QGeoAddress “, aus dem die Zuweisung erfolgt ist, kann nur zerstört oder neu 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.
QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)
Weist der angegebenen ` address ` diese Adresse zu und gibt eine Referenz auf diese Adresse zurück.
Verwandte Nicht-Mitglieder
[noexcept] size_t qHash(const QGeoAddress &address, size_t seed = 0)
Gibt den Hash-Wert für „ address “ zurück, wobei die Berechnung mit „ seed “ erfolgt.
bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
Gibt „ true “ zurück, wenn die Adresse „ lhs “ nicht mit „ rhs “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)
Gibt „ true “ zurück, wenn die Adresse „ lhs “ mit „ rhs “ übereinstimmt; andernfalls wird „ false “ zurückgegeben.
© 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.