Address QML Type

地址 QML 类型以街道地址的形式表示特定地点。更多

Import Statement: import QtPositioning

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

属性

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 属性尤其针对特定地区，通常只有其中的一个或两个属性可用或有用。

地址有一个text 属性，用于保存格式化的字符串。这是向用户显示地址的推荐方式，通常采用信封上的地址格式，但并非总是如此。text 可以从street 、city 等组成地址属性中自动生成，但也可以明确指定。详见text 。

使用示例

以下代码片段显示了地址对象的声明。

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

例如，可以将其用作地理编码查询的值，以获得地址的确切经度和纬度。

另请参见 QGeoAddress 。

属性文档

address : QGeoAddress

有关如何使用此属性在 C++ 和 QML之间建立接口的详情，请参阅"C++ 和 QML 代码之间的接口"（"Interfaces between C++ and QML Code"）。

city : string

该属性以格式化字符串的形式保存地址所在城市的信息。

country : string

该属性以单一格式字符串形式保存地址所在的国家。

countryCode : string

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

county : string

该属性以单一格式字符串形式保存地址所在的县。

district : string

该属性以单一格式字符串形式保存地址的区。

isTextGenerated : bool

该属性包含一个布尔值，如果为 true，则表示text 是由地址属性自动生成的。如果为假，则表示text 已明确分配。

postalCode : string

该属性包含地址的邮政编码（单格式字符串）。

state : string

该属性以单一格式化字符串形式保存地址所在州的信息。

street : string

该属性包含地址的街道。

注：在 Qt6 之前，该属性还可以包含单元号、建筑物名称或其他任何可能用于区分地址的内容。自 Qt6 起，此类信息使用streetNumber 属性。

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 属性。

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