QPlaceManagerEngine Class

メンバ関数のドキュメント

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

指定されたparent を使用して新しいエンジンを構築し、parameters を通じて実装固有のデータをエンジンに渡します。

[virtual noexcept] QPlaceManagerEngine::~QPlaceManagerEngine()

このエンジンを破壊する。

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

指定されたcategoryId に対応するカテゴリを返します。

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

このシグナルは、category がマネージャーエンジンのデータストアに追加された場合に発火します。category の親は、parentId によって指定されます。

このシグナルは、QPlaceManager::NotificationsFeatureをサポートするマネージャエンジンによってのみ発信されます。

dataChanged()も参照してください 。

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

このシグナルは、categoryId に対応するカテゴリがマネージャーエンジンのデータストアから削除されたときに発火します。削除されたカテゴリの親は、parentId で指定されます。

このシグナルは、QPlaceManager::NotificationsFeature をサポートするマネージャーエンジンによってのみ発火されます。

dataChanged()も参照してください 。

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

このシグナルは、マネージャーエンジンのデータストア内でcategory が変更された場合に発火します。変更されたカテゴリの親は、parentId によって指定されます。

このシグナルは、QPlaceManager::NotificationsFeature をサポートするマネージャエンジンによってのみ発火されます。

dataChanged()も参照してください 。

[virtual] QList<QPlaceCategory> QPlaceManagerEngine::childCategories(const QString &parentId) const

parentId に対応するカテゴリの子カテゴリのリストを返します。parentId が空の場合、すべての最上位カテゴリが返されます。

[virtual] QStringList QPlaceManagerEngine::childCategoryIds(const QString &categoryId) const

categoryId に対応するカテゴリの子カテゴリの識別子を返します。categoryId が空の場合、すべての最上位カテゴリの識別子が返されます。

[virtual] QPlace QPlaceManagerEngine::compatiblePlace(const QPlace &original) const

original の場所情報を、マネージャーエンジンによって保存可能な形式に整理または変更したものを返します。

変更後のバージョンには、このマネージャーでサポートされている場所の詳細のみが含まれます。場所IDなどのマネージャー固有のデータは、original からコピーされません。

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

QUrl QPlaceManagerEngine::constructIconUrl(constQPlaceIcon &icon, constQSize &size)

指定された `icon` および `size` からアイコンのURLを生成します。指定されたパラメータに最も近いアイコン画像のURLが返されます。

[signal] void QPlaceManagerEngine::dataChanged()

*

このシグナルは、エンジンが管理するデータストアに大規模な変更が生じ、エンジンがそれらの変更をクライアントがすべてのデータを再読み込みする必要があるほど根本的なものと判断した場合に、エンジンによって発行されます。

このシグナルが発信された場合、関連する変更について他のシグナルは発信されません。

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

このシグナルは、reply の処理中にエラーが検出された際に発せられます。その後、QPlaceManager::finished()シグナルが発行される可能性があります。

エラーの内容は、エラーコード `error` で表されます。`errorString ` が空でない場合、そこにはエンドユーザーではなく開発者向けのエラーの説明文が含まれます。

このシグナルとQPlaceReply::errorOccurred() は同時に発火します。

[signal] void QPlaceManagerEngine::finished(QPlaceReply *reply)

このシグナルは、reply の処理が完了したときに発せられます。

reply->error() がQPlaceReply::NoError と等しい場合、処理は正常に完了しました。

このシグナルとQPlaceReply::finished()は同時に発火します。

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

request で指定されたパラメータに基づいて、場所に関するコンテンツを取得します。

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

指定されたplaceId に対応する場所の詳細を取得します。

[virtual] QPlaceReply *QPlaceManagerEngine::initializeCategories()

マネージャーエンジンのカテゴリを初期化します。

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

優先ロケールのリストを返します。これらのロケールは、どの言語、地域、カテゴリの詳細を返すべきかについて、マネージャーエンジンへのヒントとして使用されます。

最初に指定されたロケールに対応できない場合、マネージャーエンジンは次のロケールに切り替わり、そのように順次処理されます。

ロケールのサポート状況はプロバイダによって異なります。ロケールをサポートしているプロバイダの場合、デフォルトでは「global default locale 」が使用されます。マネージャーエンジンにロケールが割り当てられていない場合、暗黙的にグローバルなデフォルトロケールが使用されます。ロケールをサポートしていないエンジンでは、ロケールリストは常に空になります。

setLocales()も参照してください 。

[protected] QPlaceManager *QPlaceManagerEngine::manager() const

このエンジンの作成に使用されたマネージャーインスタンスを返します。

QString QPlaceManagerEngine::managerName() const

このエンジン実装が、他のプラグインによって提供される実装と区別するために使用する名前を返します。

マネージャー名は、QGeoServiceProviderFactory::providerName() と同じ値に自動的に設定されます。

int QPlaceManagerEngine::managerVersion() const

このエンジン実装のバージョンを返します。

マネージャーのバージョンは、自動的に QGeoServiceProviderFactory::providerVersion() と同じ値に設定されます。

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

request で指定された場所に一致する場所のリストを含む応答を返します。

[virtual] QString QPlaceManagerEngine::parentCategoryId(const QString &categoryId) const

categoryId に対応するカテゴリの親カテゴリ識別子を返します。

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

このシグナルは、マネージャーエンジンのデータストアに場所が追加された場合に発火します。追加された具体的な場所は、placeId によって指定されます。

このシグナルは、QPlaceManager::NotificationsFeature をサポートするマネージャーエンジンによってのみ発火されます。

dataChanged()も参照してください 。

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

このシグナルは、マネージャーエンジンのデータストアから場所が削除された場合に発火します。削除された具体的な場所は、placeId で指定されます。

このシグナルは、QPlaceManager::NotificationsFeature をサポートするマネージャーエンジンによってのみ発火されます。

dataChanged()も参照してください 。

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

このシグナルは、マネージャーエンジンのデータストア内のプレースが変更された場合に発行されます。変更された具体的なプレースは、placeId によって指定されます。

このシグナルは、QPlaceManager::NotificationsFeature をサポートするマネージャーエンジンによってのみ発火されます。

dataChanged()も参照してください 。

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

マネージャーエンジンのデータストアから、categoryId に対応するカテゴリを削除します。

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

マネージャーエンジンのデータストアから、placeId に対応する場所を削除します。

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

parentId で指定されたカテゴリの子カテゴリであるcategory を保存します。parentId が空の場合、category はトップレベルのカテゴリとして保存されます。

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

指定されたplace をマネージャーエンジンのデータストアに保存します。

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

request で指定されたパラメータに基づいて場所を検索します。

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

request で指定されたパラメータに基づいて、検索用語の候補一覧を取得します。

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

優先するlocales のリストを設定します。

locales()も参照してください 。