QGeoCodeReply类

成员函数文档

[显式] QGeoCodeReply::QGeoCodeReply(QGeoCodeReply::Error error, const QString &errorString, QObject *parent = nullptr)

使用指定的error和errorString以及指定的parent构造地理编码回复。

[显式受保护] QGeoCodeReply::QGeoCodeReply(QObject *parent = nullptr)

使用指定的parent构造地理编码回复。

[虚函数 noexcept] QGeoCodeReply::~QGeoCodeReply()

销毁此回复对象。

[虚函数] void QGeoCodeReply::abort()

立即取消操作。

如果回复已完成，则此操作不会产生任何效果。

另请参阅aborted。

[信号] void QGeoCodeReply::aborted()

当操作被取消时发出此信号。

另请参阅abort。

[受保护] void QGeoCodeReply::addLocation(const QGeoLocation &location)

将位置添加到此回复的位置列表中。

QGeoCodeReply::Error QGeoCodeReply::error() const

返回此回复的错误状态。

如果结果是 QGeoCodeReply::NoError，则没有发生错误。

另请参阅setError。

[信号] void QGeoCodeReply::errorOccurred(QGeoCodeReply::Error error, const QString &errorString = QString())

当检测到此回复处理中的错误时，将发出此信号。可能随后会发出 finished() 信号。

将使用错误代码来描述错误 error。如果 errorString 不为空，它将包含错误的文本描述。

此信号和 QGeoCodingManager::errorOccurred() 将同时发出。

QString QGeoCodeReply::errorString() const

返回此回复错误状态的文本表示。

如果没有发生错误，则此函数将返回空字符串。也可能发生一个没有相关文本表示的错误，在这种情况下，也会返回空字符串。

要确定是否发生错误，请检查 QGeoCodeReply::error() 是否等于 QGeoCodeReply::NoError。

[信号] void QGeoCodeReply::finished()

当此回复完成处理时，会发出此信号。

如果 error() 等于 QGeoCodeReply::NoError，则处理成功完成。

此信号和 QGeoCodingManager::finished() 将同时发出。

另请参阅setFinished。

bool QGeoCodeReply::isFinished() const

如果操作已成功完成或遇到导致操作停止的错误，则返回 true。

qsizetype QGeoCodeReply::limit() const

返回每个数据源响应的数目限制。

如果没有设置限制，此函数将返回 -1。

如果请求的响应数小于返回的响应数，这可能大于 locations().length()。

另请参阅setLimit。

QList<QGeoLocation> QGeoCodeReply::locations() const

返回位置列表。

这些位置是 QGeoCodingManager 函数所创建的与此回复相对应的操作的结果。

另请参阅setLocations。

qsizetype QGeoCodeReply::offset() const

返回从整个结果集中开始检索结果的偏移量。

另请参阅 setOffset().

[protected] void QGeoCodeReply::setError(QGeoCodeReply::Error error, const QString &errorString)

将此响应的错误状态设置为error，并将错误文本表示为errorString。

这将还会引发errorOccurred() 和 finished 信号，按此顺序。

另请参阅 error().

[protected] void QGeoCodeReply::setFinished(bool finished)

设置此响应是否已完成 finished。

如果 finished 为真，这将导致finished 信号被引发。

如果操作成功完成，应在调用此函数之前调用QGeoCodeReply::setLocations。如果发生错误，则应使用QGeoCodeReply::setError。

另请参阅 finished().

[protected] void QGeoCodeReply::setLimit(qsizetype limit)

将每个数据源响应的数量限制设置为limit。

如果limit 为-1，则将返回所有可用响应。

另请参阅 limit().

[protected] void QGeoCodeReply::setLocations(const QList<QGeoLocation> &locations)

设置回复中locations的列表。

另请参阅 locations().

[protected] void QGeoCodeReply::setOffset(qsizetype offset)

将开始检索结果的整个结果集的偏移量设置为offset。

另请参阅 offset().

[protected] void QGeoCodeReply::setViewport(const QGeoShape &viewport)

将包含结果的视口设置为viewport。

另请参阅 viewport().

QGeoShape QGeoCodeReply::viewport() const

返回包含结果的视口。

如果创建此响应的QGeoCodingManager 函数中没有指定视口偏差，则此函数将返回 nullptr。

另请参阅 setViewport().