QPlaceReply 类
QPlaceReply 类管理由 QPlaceManager 实例启动的操作，并作为更专用回复的基础类。 更多...
| 头文件 | #include <QPlaceReply> |
| qmake | QT += location |
| 继承 | QObject |
| 继承者 | QPlaceContentReply，QPlaceDetailsReply，QPlaceIdReply，QPlaceMatchReply，QPlaceSearchReply，和 QPlaceSearchSuggestionReply |
公共类型
| 枚举 | Error { NoError, PlaceDoesNotExistError, CategoryDoesNotExistError, CommunicationError, ParseError, …, UnknownError } |
| 枚举 | Type { Reply, DetailsReply, SearchReply, SearchSuggestionReply, ContentReply, …, MatchReply } |
公共函数
| QPlaceReply(QObject *parent = nullptr) | |
| virtual | ~QPlaceReply() |
| QPlaceReply::Error | error() const |
| QString | errorString() const |
| bool | isFinished() const |
| virtual QPlaceReply::Type | type() const |
公共槽
| virtual void | abort() |
信号
| void | aborted() |
| void | contentUpdated() |
| void | errorOccurred(QPlaceReply::Error error, const QString &errorString = QString()) |
| void | finished() |
保护函数
| void | setError(QPlaceReply::Error error, const QString &errorString) |
| void | setFinished(bool finished) |
详细描述
QPlaceReply 及其所有专用子类管理相应操作的状态和结果。QPlaceReply 本身用于没有结果的操作，即只需知道操作是否成功。
可以使用 finished() 信号来监控操作的进度。一旦操作完成，error() 和 errorString() 方法提供有关操作是否成功完成的信息。如果成功，回复将包含该操作的结果，即每个子类将具有检索操作结果适当的功能。
另请参阅 QPlaceManager.
成员类型文档
枚举 QPlaceReply::错误
描述操作过程中发生的错误。
| 常量 | 值 | 描述 |
|---|---|---|
QPlaceReply::NoError | 0 | 没有发生错误 |
QPlaceReply::PlaceDoesNotExistError | 1 | 无法找到指定的地点 |
QPlaceReply::CategoryDoesNotExistError | 2 | 无法找到指定的类别 |
QPlaceReply::CommunicationError | 3 | 与服务提供商通信时发生错误。 |
QPlaceReply::ParseError | 4 | 服务提供商的响应或导入文件处于不可识别的格式。 |
QPlaceReply::PermissionsError | 5 | 操作失败，因为权限不足。 |
QPlaceReply::UnsupportedError | 6 | 服务提供商不支持该操作。 |
QPlaceReply::BadArgumentError | 7 | 提供的参数无效。 |
QPlaceReply::CancelError | 8 | 操作已取消。 |
QPlaceReply::UnknownError | 9 | 发生了一个不适用于其他任何类别的错误。 |
枚举 QPlaceReply::类型
描述响应的类型。
| 常量 | 值 | 描述 |
|---|---|---|
QPlaceReply::Reply | 0 | 这是一个通用响应。 |
QPlaceReply::DetailsReply | 1 | 这是提取地点详细信息时的响应。 |
QPlaceReply::SearchReply | 2 | 这是地点搜索操作的响应。 |
QPlaceReply::SearchSuggestionReply | 3 | 这是搜索建议操作的响应。 |
QPlaceReply::ContentReply | 4 | 这是与地点相关的内容的响应。 |
QPlaceReply::IdReply | 5 | 这是一个返回地点或类别的标识符的响应。通常用于地点或类别保存和删除操作。 |
QPlaceReply::MatchReply | 6 | 这是一个返回匹配另一个提供程序地点的响应。 |
成员函数文档
[显式] QPlaceReply::QPlaceReply(QObject *parent = nullptr)
使用指定的 parent 构造响应对象。
[虚拟 noexcept] QPlaceReply::~QPlaceReply()
销毁响应对象。
[虚拟槽] void QPlaceReply::abort()
立即取消操作。
另请参阅aborted。
[信号] void QPlaceReply::aborted()
当操作被取消时发出此信号。
另请参阅abort。
[信号] void QPlaceReply::contentUpdated()
当此响应有更新的内容可用时发出此信号。根据插件的不同，此信号可能会在 QPlaceReply::finished() 发出之前多次发出，因为某些后端能够异步和增量地返回请求的内容。
注意： 不要在此信号连接的槽中删除或删除Later此响应对象。只能在 QPlaceReply::finished。
QPlaceReply::Error QPlaceReply::error() const
返回错误代码。
另请参阅setError。
[信号] void QPlaceReply::errorOccurred(QPlaceReply::Error 错误, const QString &错误字符串 = QString())
当在处理此回复时检测到错误时，将发出此信号。很可能会随后发出 finished() 信号。
错误将由错误代码 错误 描述。如果 错误字符串 不为空，它将包含为开发者而不是最终用户准备的错误文本描述。
此信号和 QPlaceManager::errorOccurred() 将同时发出。
注意：不要在连接到此信号的槽中删除此回复对象。请使用 deleteLater()。
QString QPlaceReply::errorString() const
返回回复的错误字符串。错误字符串是仅用于开发者的，不适合显示给最终用户。
如果未发生错误，字符串为空。
[信号] void QPlaceReply::finished()
当此回复完成处理时，将发出此信号。
如果 error() 等于 QPlaceReply::NoError，则处理成功完成。
此信号和 QPlaceManager::finished() 将同时发出。
注意：不要在连接到此信号的槽中删除此回复对象。请使用 deleteLater()。
另请参阅：setFinished()。
bool QPlaceReply::isFinished() const
如果回复已完成，则返回 true。
[保护] void QPlaceReply::setError(QPlaceReply::Error 错误, const QString &错误字符串)
设置回复的 错误 和 错误字符串。此函数不会导致发出 QPlaceReply::errorOccurred(QPlaceReply::Error, const QString &errorString) 信号。
另请参阅：error()。
[保护] void QPlaceReply::setFinished(bool 完成)
设置回复是否完成的状态。此函数不会导致发出 finished() 信号。
另请参阅：finished()。
[虚函数] QPlaceReply::Type QPlaceReply::type() const
返回回复的类型。
© 2024 The Qt Company Ltd. 此处包含的文档贡献者是各自所有者的版权。此处提供的文档受 GNU 自由文档许可证版本 1.3 的条款许可，由自由软件基金会发布。Qt 和相应的标志是 The Qt Company Ltd. 在芬兰和其他国家/地区的商标。所有其他商标均为其各自所有者的财产。
