Address QML Type

Der QML-Typ Adresse stellt einen bestimmten Ort als Straßenadresse dar. Mehr...

Import Statement: import QtPositioning

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

address : QGeoAddress
city : string
country : string
countryCode : string
county : string
district : string
isTextGenerated : bool
postalCode : string
state : string
street : string
streetNumber : string (since QtPositioning 6.2)
text : string

Detaillierte Beschreibung

Eine Adresse wird als Dateneinheit für Abfragen wie die (umgekehrte) Geokodierung oder die Ortssuche verwendet - viele dieser Operationen akzeptieren entweder eine Adresse oder geben eine zurück.

Nicht alle Eigenschaften einer Adresse sind notwendigerweise in allen Teilen der Welt und in allen Gebietsschemata verfügbar oder relevant. Die Eigenschaften district, state und county sind für viele Datenquellen besonders gebietsspezifisch, und oft sind nur eine oder zwei dieser Eigenschaften verfügbar oder nützlich.

Die Adresse hat eine text Eigenschaft, die eine formatierte Zeichenkette enthält. Dies ist die empfohlene Art, dem Benutzer eine Adresse anzuzeigen, und nimmt normalerweise das Format einer Adresse an, wie sie auf einem Briefumschlag zu finden ist, was aber nicht immer der Fall ist. Die Eigenschaft text kann automatisch aus konstituierenden Adresseigenschaften wie street, city usw. generiert werden, kann aber auch explizit zugewiesen werden. Siehe text für Details.

Beispielverwendung

Der folgende Codeschnipsel zeigt die Deklaration eines Address-Objekts.

Address {
    id: address
    street: "53 Brandl St"
    city: "Eight Mile Plains"
    country: "Australia"
    countryCode: "AUS"
}

Dieses könnte dann z. B. als Wert einer Geokodierungsabfrage verwendet werden, um den genauen Längen- und Breitengrad für die Adresse zu erhalten.

Siehe auch QGeoAddress.

Dokumentation der Eigenschaft

address : QGeoAddress

Einzelheiten zur Verwendung dieser Eigenschaft für die Schnittstelle zwischen C++ und QML finden Sie unter"Schnittstellen zwischen C++- und QML-Code".

city : string

Diese Eigenschaft enthält die Stadt der Adresse als einzelnen formatierten String.

country : string

Diese Eigenschaft enthält das Land der Adresse in Form einer einzelnen formatierten Zeichenkette.

countryCode : string

Diese Eigenschaft enthält den Ländercode der Adresse in Form einer einzelnen formatierten Zeichenkette.

county : string

Diese Eigenschaft enthält das County der Adresse als einzelne formatierte Zeichenkette.

district : string

Diese Eigenschaft enthält den Bezirk der Adresse als einzelne formatierte Zeichenkette.

isTextGenerated : bool

Diese Eigenschaft enthält einen booleschen Wert, der, wenn er wahr ist, angibt, dass text automatisch aus den Adresseigenschaften generiert wird. Ist sie falsch, bedeutet dies, dass text explizit zugewiesen wurde.

postalCode : string

Diese Eigenschaft enthält die Postleitzahl der Adresse in Form einer einzelnen formatierten Zeichenfolge.

state : string

Diese Eigenschaft enthält das Bundesland der Adresse in Form einer einzelnen formatierten Zeichenfolge.

street : string

Diese Eigenschaft enthält die Straße der Adresse.

Hinweis: Vor Qt6 konnte diese Eigenschaft auch Dinge wie eine Wohnungsnummer, einen Gebäudenamen oder irgendetwas anderes enthalten, das zur Unterscheidung einer Adresse von einer anderen verwendet werden konnte. Seit Qt6 wird die Eigenschaft streetNumber für solche Informationen verwendet.

streetNumber : string [since QtPositioning 6.2]

Diese Eigenschaft enthält die Straßennummer der Adresse, wie z.B. eine Hausnummer, einen Gebäudenamen oder irgendetwas anderes, das zur Unterscheidung einer Adresse von einer anderen verwendet werden kann.

Diese Eigenschaft wurde in QtPositioning 6.2 eingeführt.

text : string

Diese Eigenschaft enthält die Adresse als einen einzelnen formatierten String. Es ist die empfohlene Zeichenkette für die Anzeige der Adresse für den Benutzer. Normalerweise nimmt sie das Format einer Adresse, wie sie auf einem Briefumschlag zu finden ist, aber das ist nicht immer der Fall.

Die Adresse text wird entweder automatisch generiert oder explizit zugewiesen; dies lässt sich durch Überprüfung von isTextGenerated feststellen.

Wird text eine leere Zeichenkette zugewiesen, wird isTextGenerated auf "true" gesetzt und text gibt eine Zeichenkette zurück, die gemäß countryCode und auf der Grundlage der Eigenschaften der Adresse lokal formatiert ist. Eine Änderung der Adresseigenschaften wie street, city usw. kann dazu führen, dass sich der Inhalt von text ändert.

Wenn text eine nicht leere Zeichenkette zugewiesen wird, wird isTextGenerated auf false gesetzt und text gibt immer die explizit zugewiesene Zeichenkette zurück. Die Änderung von Adresseigenschaften hat keine Auswirkungen auf die Eigenschaft text.

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