QGeoAddress 类

QGeoAddress 类表示 QGeoLocation 的地址。 更多...

头文件 #include <QGeoAddress>
CMakefind_package(Qt6 REQUIRED COMPONENTS Positioning)
target_link_libraries(mytarget PRIVATE Qt6::Positioning)
qmakeQT += positioning

公共函数

QGeoAddress()
QGeoAddress(const QGeoAddress &other)
(自 6.2) QGeoAddress(QGeoAddress &&other)
~QGeoAddress()
QStringcity() const
voidclear()
QStringcountry() const
QStringcountryCode() const
QStringcounty() const
QStringdistrict() const
boolisEmpty() const
boolisTextGenerated() const
QStringpostalCode() const
voidsetCity(const QString &city)
voidsetCountry(const QString &country)
voidsetCountryCode(const QString &countryCode)
voidsetCounty(const QString &county)
voidsetDistrict(const QString &district)
voidsetPostalCode(const QString &postalCode)
voidsetState(const QString &state)
voidsetStreet(const QString &street)
(自 6.2) voidsetStreetNumber(const QString &streetNumber)
voidsetText(const QString &text)
QStringstate() const
QStringstreet() const
(自 6.2) QStringstreetNumber() const
QStringtext() const
QGeoAddress &operator=(const QGeoAddress &address)
(自 6.2) QGeoAddress &operator=(QGeoAddress &other)
size_tqHash(const QGeoAddress &address, size_t seed = 0)
booloperator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)
booloperator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

详细描述

地址的属性已标准化为美国特性名称,可以映射到本地特性级别(例如州与德国的“Bundesland”匹配)。

地址包含一个用于显示的目的的text()()以及访问地址组件的额外属性

成员函数文档

QGeoAddress::QGeoAddress()

默认构造函数。

QGeoAddress::QGeoAddress(const QGeoAddress &other)

构建一个other的副本。

[noexcept, since 6.2] QGeoAddress::QGeoAddress(QGeoAddress &&other)

通过移动从other构建地理地址对象。

注意:已移动的QGeoAddress对象只能被销毁或赋值。调用构造函数或赋值运算符之外的函数的效果是未定义的。

此函数自Qt 6.2引入。

[noexcept] QGeoAddress::~QGeoAddress()

销毁此地址。

QString QGeoAddress::city() const

返回城市。

另请参阅setCity

void QGeoAddress::clear()

清除地址的所有数据字段。

QString QGeoAddress::country() const

返回国家名称。

另请参阅setCountry

QString QGeoAddress::countryCode() const

返回根据ISO 3166-1 alpha-3的国家代码。

另请参阅setCountryCode

QString QGeoAddress::county() const

返回县。县被认为是国家以下的第二个子划分。

另请参阅setCounty

QString QGeoAddress::district() const

返回区。区被认为是城市以下的子划分。

另请参阅setDistrict

bool QGeoAddress::isEmpty() const

返回此地址是否为空。如果地址的所有字段都为空,则认为地址为空。

bool QGeoAddress::isTextGenerated() const

如果QGeoAddress::text()从地址元素自动生成,则返回true,否则如果text()已被显式分配,则返回false。

另请参阅text()和setText

QString QGeoAddress::postalCode() const

返回邮政编码。

另请参阅 setPostalCode().

void QGeoAddress::setCity(const QString &city)

设置城市

另请参阅 city().

void QGeoAddress::setCountry(const QString &country)

设置国家名称。

另请参阅 country().

void QGeoAddress::setCountryCode(const QString &countryCode)

根据ISO 3166-1 alpha-3设置countryCode

另请参阅 countryCode().

void QGeoAddress::setCounty(const QString &county)

设置

另请参阅 county().

void QGeoAddress::setDistrict(const QString &district)

设置地区

另请参阅 district().

void QGeoAddress::setPostalCode(const QString &postalCode)

设置邮政编码

另请参阅 postalCode().

void QGeoAddress::setState(const QString &state)

设置州/省

另请参阅 state().

void QGeoAddress::setStreet(const QString &street)

将街道设置为街道

注意:在Qt6之前,这可能还包含诸如单元编号、楼名或其他用于区分地址的事项。请使用setStreetNumber()来设置这些数据。

另请参阅 street() 和 setStreetNumber().

[since 6.2] void QGeoAddress::setStreetNumber(const QString &streetNumber)

设置街道编号为streetNumber

这也可以包含诸如单元编号、楼名或其他可能用于区分地址的事项。

注意:在Qt6之前,此信息是由 setStreet() 方法设置的。

此函数自Qt 6.2引入。

另请参阅 streetNumber() 和 setStreet().

void QGeoAddress::setText(const QString &text)

如果text非空,则会显式地将text赋值为返回的字符串text()。函数isTextGenerated() 将返回false。

如果text为空,表示text()应自动从地址元素生成。函数isTextGenerated() 将返回true。

另见text

QString QGeoAddress::state() const

返回州(或省)。州被认为是国家下的第一个次级分区。

另见setState

QString QGeoAddress::street() const

返回街道名称。

注意:在Qt 6之前,此字符串也可以包含类似楼号、建筑物名称等内容,用于区分不同的地址。现在请使用streetNumber() 获取此数据。

另见setStreet() 和streetNumber

[自6.2起] QString QGeoAddress::streetNumber() const

返回街道号。

这也可以包含诸如单元编号、楼名或其他可能用于区分地址的事项。

注意:在Qt 6之前,此信息由street() 方法返回。

此函数自Qt 6.2引入。

另见setStreetNumber() 和street

QString QGeoAddress::text() const

以单个格式化字符串的形式返回地址。这是向用户显示地址的推荐字符串。它通常采用信封上地址的格式,但并不总是如此。

地址文本要么是自动生成的,要么是显式指定的。可以通过检查isTextGenerated来确定这一点。

如果通过setText() 提供了空字符串,则isTextGenerated() 将设置为true,而 text() 将返回一个字符串,它根据countryCode() 进行本地格式化,并基于地址元素(如街道、城市等)。由于文本字符串是根据地址元素生成的,因此 text()、setStreet()、text() 等一系列调用可能对每次调用 text() 都返回不同的字符串。

如果通过setText() 提供了非空字符串,则isTextGenerated() 将设置为false,而 text() 总是返回显式指定的字符串。对 setStreetsetCity 等其他元素的修改调用不会影响由 text() 返回的结果字符串。

另见setText

QGeoAddress &QGeoAddress::operator=(const QGeoAddress &address)

将给定的address 赋值给此地址,并返回对此地址的引用。

[默认值,自6.2版本起] QGeoAddress &QGeoAddress::operator=(QGeoAddress &other)

other移动赋值到该地址,并返回对该地址的引用。

注意:从该地址移动出来的QGeoAddress对象只能被销毁或赋值。调用除析构函数或赋值运算符之外的其他函数的效果是未定义的。

此函数自Qt 6.2引入。

相关非成员函数

[noexcept] size_t qHash(const QGeoAddress &address, size_t seed = 0)

返回address的哈希值,使用seed进行计算。

bool operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs)

如果lhs地址不等于rhs,则返回true,否则返回false

bool operator==(const QGeoAddress &lhs, const QGeoAddress &rhs)

如果lhs地址等于rhs,则返回true,否则返回false

© 2024 The Qt Company Ltd. 本文件中的文档贡献版权属于其各自所有者。本文件提供的文档是根据自由软件基金会发布的GNU自由文档许可证版本1.3的条款许可的。Qt 以及相应的标志是芬兰的 The Qt Company Ltd 和/或全球其他国家的商标。所有其他商标均为其各自所有者的财产。