Auf dieser Seite

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)
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.