QGeoAddress Class

Die Klasse QGeoAddress repräsentiert eine Adresse eines QGeoLocation. Mehr...

Kopfzeile: #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 sind auf US-Feature-Namen normalisiert und können auf die lokalen Feature-Ebenen abgebildet werden (z.B. State entspricht "Bundesland" in Deutschland).

Die Adresse enthält ein text() für Anzeigezwecke und zusätzliche Eigenschaften für den Zugriff auf die Komponenten einer Adresse:

Dokumentation der Mitgliedsfunktionen

QGeoAddress::QGeoAddress()

Standard-Konstruktor.

QGeoAddress::QGeoAddress(const QGeoAddress &other)

Konstruiert eine Kopie von other.

[noexcept, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)

Konstruiert ein Geo-Adress-Objekt durch Verschieben von other.

Hinweis: Das verschobene QGeoAddress-Objekt kann nur zerstört oder zugewiesen werden. Die Wirkung des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.

Diese Funktion wurde in Qt 6.2 eingeführt.

[noexcept] QGeoAddress::~QGeoAddress()

Zerstört diese Adresse.

QString QGeoAddress::city() const

Gibt die 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

Liefert den Ländercode nach ISO 3166-1 alpha-3

Siehe auch setCountryCode().

QString QGeoAddress::county() const

Gibt den Landkreis zurück. Die Grafschaft wird als zweite Unterteilung unterhalb von Land betrachtet.

Siehe auch setCounty().

QString QGeoAddress::district() const

Gibt den Bezirk zurück. Der Bezirk wird als Unterteilung unterhalb der Stadt betrachtet.

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 erzeugt wird, andernfalls false, 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)

Setzt die city.

Siehe auch city().

void QGeoAddress::setCountry(const QString &country)

Legt den Namen country fest.

Siehe auch country().

void QGeoAddress::setCountryCode(const QString &countryCode)

Setzt die countryCode gemäß ISO 3166-1 alpha-3

Siehe auch countryCode().

void QGeoAddress::setCounty(const QString &county)

Setzt die county.

Siehe auch county().

void QGeoAddress::setDistrict(const QString &district)

Setzt die district.

Siehe auch district().

void QGeoAddress::setPostalCode(const QString &postalCode)

Setzt die postalCode.

Siehe auch postalCode().

void QGeoAddress::setState(const QString &state)

Setzt die state.

Siehe auch state().

void QGeoAddress::setStreet(const QString &street)

Setzt den Straßennamen auf street.

Hinweis: Vor Qt6 konnte dies auch Dinge wie eine Einheitsnummer, einen Gebäudenamen oder irgendetwas anderes enthalten, das verwendet werden könnte, um eine Adresse von einer anderen zu unterscheiden. Verwenden Sie setStreetNumber(), um diese Daten jetzt zu setzen.

Siehe auch street() und setStreetNumber().

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

Setzt die Straßennummer auf streetNumber.

Dies kann auch Dinge wie eine Einheitsnummer, einen Gebäudenamen oder irgendetwas anderes enthalten, das zur Unterscheidung einer Adresse von einer anderen verwendet werden kann.

Hinweis: Vor Qt6 wurde diese Information mit der Methode setStreet() gesetzt.

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 von text() zurückzugebende Zeichenkette zugewiesen. isTextGenerated() gibt false zurück.

Wenn text leer ist, wird angegeben, dass text() automatisch aus den Adresselementen generiert werden soll. isTextGenerated() gibt true zurück.

Siehe auch text().

QString QGeoAddress::state() const

Gibt den Staat zurück. Der Staat wird als erste Unterteilung unterhalb von Land betrachtet.

Siehe auch setState().

QString QGeoAddress::street() const

Gibt den Straßennamen zurück.

Hinweis: Vor Qt6 konnte dies auch Dinge wie eine Einheitsnummer, einen Gebäudenamen oder irgendetwas anderes enthalten, das verwendet werden könnte, um eine Adresse von einer anderen zu unterscheiden. Verwenden Sie jetzt streetNumber(), um diese Daten zu erhalten.

Siehe auch setStreet() und streetNumber().

[since 6.2] QString QGeoAddress::streetNumber() const

Gibt die Straßennummer zurück.

Diese kann auch Dinge wie eine Einheitsnummer, einen Gebäudenamen oder irgendetwas anderes enthalten, das zur Unterscheidung einer Adresse von einer anderen verwendet werden kann.

Hinweis: Vor Qt6 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 mit other aus. Dieser Vorgang ist sehr schnell und schlägt nie fehl.

Diese Funktion wurde in Qt 6.2 eingeführt.

QString QGeoAddress::text() const

Gibt die Adresse als einzelne formatierte Zeichenfolge zurück. Dies ist die empfohlene Zeichenfolge für die Anzeige der Adresse beim Benutzer. In der Regel wird das Format einer Adresse, wie sie auf einem Briefumschlag zu finden ist, übernommen, was jedoch nicht immer der Fall sein muss.

Der Adresstext wird entweder automatisch generiert oder explizit zugewiesen. Dies kann durch Überprüfung von isTextGenerated festgestellt werden.

Wenn setText() eine leere Zeichenkette übergeben wird, wird isTextGenerated() auf true gesetzt und text() gibt eine Zeichenkette zurück, die gemäß countryCode() lokal formatiert ist und auf den Elementen der Adresse wie Straße, Ort usw. basiert. Da der Textstring aus den Adresselementen erzeugt wird, kann eine Folge von Aufrufen wie text(), setStreet(), text() bei jedem Aufruf von text() unterschiedliche Strings zurückgeben.

Wenn setText() eine nicht leere Zeichenkette übergeben wird, wird isTextGenerated() auf false gesetzt und text() gibt immer die explizit zugewiesene Zeichenkette zurück. Aufrufe zur Änderung anderer Elemente wie setStreet(), setCity() usw. haben keinen Einfluss auf die resultierende Zeichenkette von text().

Siehe auch setText().

[default, since 6.2] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

Verschieben - weist other dieser Adresse zu und gibt einen Verweis auf diese Adresse zurück.

Hinweis: Das von QGeoAddress verschobene Objekt kann nur zerstört oder zugewiesen werden. Der Effekt des Aufrufs anderer Funktionen als des Destruktors oder eines der Zuweisungsoperatoren ist undefiniert.

Diese Funktion wurde in Qt 6.2 eingeführt.

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

Weist dieser Adresse die angegebene address zu und gibt einen Verweis 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 seed für die Berechnung verwendet wird.

bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)

Gibt true zurück, wenn lhs Adresse nicht gleich rhs ist, andernfalls false.

bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

Gibt true zurück, wenn die Adresse lhs gleich rhs ist, andernfalls false.

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