Address QML Type

QML 类型“Address”将特定位置表示为街道地址。更多内容...

• 所有成员列表（包括继承的成员）

属性

• 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

详细说明

地址被用作（反向）地理编码或地点搜索等查询的数据单元——此类操作中，许多要么接受地址作为输入，要么返回地址作为结果。

地址的并非所有属性在世界各地及所有地区都一定可用或相关。对于许多数据源而言，district 、state 和county 这三个属性具有明显的地域特异性，通常其中仅有一两个可用或有用。

Address 对象具有text 属性，该属性存储一个格式化字符串。这是向用户显示地址的推荐方式，通常采用信封上常见的地址格式，但并非总是如此。text 可能由street 、city 等组成地址属性自动生成，但也支持显式赋值。详情请参阅text 。

用法示例

以下代码片段展示了 Address 对象的声明。

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

例如，该对象可作为地理编码查询的参数，以获取该地址的确切经纬度。

另请参阅 QGeoAddress 。

属性文档

address : QGeoAddress

有关如何使用此属性在 C++ 和 QML 之间进行交互的详细信息，请参阅“C++ 与 QML 代码之间的接口”。

city : string

该属性以单个格式化字符串的形式存储地址所在的城市。

country : string

该属性以单个格式化字符串的形式存储地址所在的国家/地区。

countryCode : string

该属性以单个格式化字符串的形式存储地址的国家代码。

county : string

该属性以单个格式化字符串的形式存储地址所属的县。

district : string

该属性以单个格式化字符串的形式存储地址所属的区。

isTextGenerated : bool

该属性存储一个布尔值，若为 true，则表示text 是根据地址属性自动生成的；若为 false，则表示text 已被显式指定。

postalCode : string

该属性将地址的邮政编码作为单个格式化字符串存储。

state : string

该属性以单个格式化字符串的形式保存地址的状态。

street : string

该属性存储地址所属的街道名称。

streetNumber : string [since QtPositioning 6.2]

该属性存储地址的街区编号，例如单元号、楼名，或任何其他可用于区分不同地址的信息。

该属性在 QtPositioning 6.2 中引入。

text : string

该属性将地址作为一条格式化的字符串存储。这是向用户显示地址时推荐使用的字符串。它通常采用信封上地址的格式，但并不总是如此。

地址text 可能是自动生成的，也可能是显式赋予的，可通过检查isTextGenerated 来确定。

如果将空字符串赋值给text ，则isTextGenerated 将被设为 true，且text 将返回一个字符串，该字符串根据countryCode 以及地址的属性进行本地格式化。修改地址属性（如street 、city 等）可能会导致text 的内容发生变化。

如果将一个非空字符串赋值给text ，则isTextGenerated 将被设置为 false，而text 将始终返回显式赋值的字符串。修改地址属性不会影响text 属性。