QGeoAddress 类
QGeoAddress 类表示 QGeoLocation 的地址。 更多...
头文件 | #include <QGeoAddress> |
CMake | find_package(Qt6 REQUIRED COMPONENTS Positioning) target_link_libraries(mytarget PRIVATE Qt6::Positioning) |
qmake | QT += positioning |
公共函数
QGeoAddress() | |
QGeoAddress(const QGeoAddress &other) | |
(自 6.2) | QGeoAddress(QGeoAddress &&other) |
~QGeoAddress() | |
QString | city() const |
void | clear() |
QString | country() const |
QString | countryCode() const |
QString | county() const |
QString | district() const |
bool | isEmpty() const |
bool | isTextGenerated() const |
QString | postalCode() const |
void | setCity(const QString &city) |
void | setCountry(const QString &country) |
void | setCountryCode(const QString &countryCode) |
void | setCounty(const QString &county) |
void | setDistrict(const QString &district) |
void | setPostalCode(const QString &postalCode) |
void | setState(const QString &state) |
void | setStreet(const QString &street) |
(自 6.2) void | setStreetNumber(const QString &streetNumber) |
void | setText(const QString &text) |
QString | state() const |
QString | street() const |
(自 6.2) QString | streetNumber() const |
QString | text() const |
QGeoAddress & | operator=(const QGeoAddress &address) |
(自 6.2) QGeoAddress & | operator=(QGeoAddress &other) |
相关非成员
size_t | qHash(const QGeoAddress &address, size_t seed = 0) |
bool | operator!=(const QGeoAddress &lhs, const QGeoAddress &rhs) |
bool | operator==(const QGeoAddress &lhs, const QGeoAddress &rhs) |
成员函数文档
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。
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() 总是返回显式指定的字符串。对 setStreet、setCity 等其他元素的修改调用不会影响由 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 和/或全球其他国家的商标。所有其他商标均为其各自所有者的财产。