QPlaceManagerEngine 类

成员函数文档

[显式] QPlaceManagerEngine::QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)

使用指定的 parent 和 parameters 构造一个新的引擎，将这些参数传递到引擎以提供任何实现特定数据。

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

销毁此引擎。

[virtual] QPlaceCategory QPlaceManagerEngine::category(const QString &categoryId) const

返回与给定 categoryId 对应的类别。

[信号] void QPlaceManagerEngine::categoryAdded(const QPlaceCategory &category, const QString &parentId)

如果在管理引擎的数据集中添加了 category，则发出此信号。通过 parentId 指定 category 的父级。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[信号] void QPlaceManagerEngine::categoryRemoved(const QString &categoryId, const QString &parentId)

当从管理引擎的数据集中删除与 categoryId 对应的类别时，会发出此信号。被删除类别的父级通过 parentId 指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[信号] void QPlaceManagerEngine::categoryUpdated(const QPlaceCategory &category, const QString &parentId)

当在管理器引擎的存储数据中修改了类别时，将发射此信号。修改的类别的父类别由parentId指定。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[虚函数] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

返回与parentId对应的类别的所有子类别的列表。如果parentId为空，则返回所有顶级类别。

[虚函数] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

返回与categoryId对应的类别的子类别标识符。如果categoryId为空，则返回所有顶级类别标识符。

[虚函数] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

返回一个裁剪或修改过的original地点版本，该版本适合由管理器引擎保存。

修改版本中只包含此管理器支持的位置细节。例如，位置ID之类的特定数据不会从original复制过来。

[虚函数] QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size) const

QUrl QPlaceManagerEngine::constructIconUrl(const QPlaceIcon &icon, const QSize &size)

从指定的icon和size构造图标URL。返回最接近指定参数的图标图像的URL。

[信号] void QPlaceManagerEngine::dataChanged()

*

如果引擎的下层数据存储器发生了大规模变化，并且引擎认为这些变化足够剧烈，需要客户端重新加载数据时，将发射此信号。

如果发射了该信号，则不会为关联的更改发射其他信号。

[信号] void QPlaceManagerEngine::errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())

当在处理reply时检测到错误时，将发射此信号。很可能会随后发射QPlaceManager::finished()信号。

错误将由错误代码error描述。如果errorString不为空，它将包含一个用于开发人员而不是最终用户的错误文本描述。

此信号和QPlaceReply::errorOccurred()将在同一时间发出。

[信号] void QPlaceManagerEngine::finished(QPlaceReply *reply)

当reply处理完成时，发出此信号。

如果reply->error()等于QPlaceReply::NoError，则表示处理成功完成。

此信号和QPlaceReply::finished()将在同一时间发出。

[虚拟] QPlaceContentReply *QPlaceManagerEngine::getPlaceContent(const QPlaceContentRequest &request)

根据request中指定的参数检索地点的内容。

[虚拟] QPlaceDetailsReply *QPlaceManagerEngine::getPlaceDetails(const QString &placeId)

检索给定placeId对应地点的详细信息。

[虚拟] QPlaceReply *QPlaceManagerEngine::initializeCategories()

初始化管理引擎的分类。

[虚拟] QList<QLocale> QPlaceManagerEngine::locales() const

返回首选的区域设置列表。这些区域设置用作提示，告诉管理引擎应在何种语言下返回地点和分类的详细信息。

如果第一个指定的区域设置无法满足，管理引擎将回退到下一个，依此类推。

对区域设置的支持可能因提供者而异。对于那些支持的区域设置，默认情况下，将使用全局默认区域设置。如果管理引擎没有分配区域设置，它将隐式使用全局默认区域设置。对于不支持区域设置的引擎，区域设置列表始终为空。

另请参阅setLocales。

[保护] QPlaceManager *QPlaceManagerEngine::manager() const

返回用于创建此引擎的管理实例。

QString QPlaceManagerEngine::managerName() const

返回此引擎实现使用的名称，以区分其他插件提供的实现。

管理名称自动设置为与QGeoServiceProviderFactory::providerName()相同。

int QPlaceManagerEngine::managerVersion() const

返回此引擎实现的版本。

管理版本自动设置为与QGeoServiceProviderFactory::providerVersion()相同。

[虚拟] QPlaceMatchReply *QPlaceManagerEngine::matchingPlaces(const QPlaceMatchRequest &request)

返回一个包含与所指定内容相对应的地点的列表的回复。

[虚拟] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

返回对应于 categoryId 的类别的父类别标识符。

[信号] void QPlaceManagerEngine::placeAdded(const QString &placeId)

如果在管理引擎的数据存储中添加了一个地点，则会发出此信号。通过 placeId 指定特别添加的地点。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[信号] void QPlaceManagerEngine::placeRemoved(const QString &placeId)

如果在管理引擎的数据存储中删除了一个地点，则会发出此信号。由 placeId 指定已删除的特定地点。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[信号] void QPlaceManagerEngine::placeUpdated(const QString &placeId)

如果在管理引擎的数据存储中修改了一个地点，则会发出此信号。通过 placeId 指定修改的特定地点。

此信号仅由支持 QPlaceManager::NotificationsFeature 的管理引擎发出。

另请参阅：dataChanged。

[虚拟] QPlaceIdReply *QPlaceManagerEngine::removeCategory(const QString &categoryId)

从管理引擎的数据存储中删除与 categoryId 相对应的类别。

[虚拟] QPlaceIdReply *QPlaceManagerEngine::removePlace(const QString &placeId)

从管理引擎的数据存储中删除与 placeId 相对应的地点。

[虚拟] QPlaceIdReply *QPlaceManagerEngine::saveCategory(const QPlaceCategory &category, const QString &parentId)

保存一个 category，该 category 是由 parentId 指定的类别的子类别。一个空的 parentId 表示 category 被保存为顶级类别。

[虚拟] QPlaceIdReply *QPlaceManagerEngine::savePlace(const QPlace &place)

将指定的 place 保存到管理引擎的数据存储中。

[虚拟] QPlaceSearchReply *QPlaceManagerEngine::search(const QPlaceSearchRequest &request)

根据 request 中指定的参数搜索地点。

[虚拟] QPlaceSearchSuggestionReply *QPlaceManagerEngine::searchSuggestions(const QPlaceSearchRequest &request)

根据请求中指定的参数请求一组搜索词建议。

[虚拟] void QPlaceManagerEngine::setLocales(const QList<QLocale> &locales)

设置首选的 locales 列表。

另请参阅locales()。