地址 QML 类型

地址 QML 类型表示一个具体位置，如街道地址。 更多...

导入语句import QtPositioning

属性

详细说明

地址用于查询，如（反向）地理编码或地点搜索的数据单位 - 许多这些操作接受地址或返回地址。

地址的所有属性不一定在世界所有地区和所有区域内都可用或相关。例如，地区、州 和 县 属性对于许多数据源特别特定，通常只有其中之一或两个可用或有用。

地址具有一个 text 属性，该属性存储一个格式化的字符串。这是向用户显示地址的首选方式，通常采用信封上地址的格式，但这并不总是如此。《text》可能由地址的构成属性，如街道、城市和如此等等自动生成，但也可以显式分配。请参阅text 以获取详细信息。

示例用法

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

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

该属性保存一个布尔值，如果为真，表示 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 属性。


© 2024 Qt公司有限公司。本文档中包含的贡献是各自所有者的版权。提供的文档是在自由软件基金会发布的GNU自由文档许可协议第1.3版下许可的，如[链接](http://www.gnu.org/licenses/fdl.html)。Qt及其相关标志是Qt公司在芬兰及全球其他国家的商标。[商标链接](https://doc.qt.ac.cn/qt/trademarks.html)。所有其他商标均为各自所有者的财产。