Address QML Type

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

• 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 davon 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 in Form einer einzelnen formatierten Zeichenfolge.

country : string

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

countryCode : string

Diese Eigenschaft enthält den Ländercode der Adresse in Form einer einzigen formatierten Zeichenfolge.

county : string

Diese Eigenschaft enthält den Bezirk der Adresse in Form einer einzigen formatierten Zeichenfolge.

district : string

Diese Eigenschaft enthält den Bezirk der Adresse als eine einzige formatierte Zeichenfolge.

isTextGenerated : bool

Diese Eigenschaft enthält einen booleschen Wert, der, wenn er wahr ist, anzeigt, 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 den Status der Adresse in Form einer einzigen formatierten Zeichenfolge.

street : string

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

streetNumber : string [since QtPositioning 6.2]

Diese Eigenschaft enthält die Straßennummer der Adresse, wie z.B. eine Einheitsnummer, 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 eine einzige formatierte Zeichenfolge. Es ist die empfohlene Zeichenfolge für die Anzeige der Adresse für den 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.

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

Wenn text eine leere Zeichenkette zugewiesen wird, 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.