QPlaceManagerEngine Class

QPlaceManagerEngine クラスは、プレイス機能へのアクセスを提供したいQGeoServiceProvider プラグインの実装者のためのインターフェイスを提供します。詳細...

Header: #include <QPlaceManagerEngine>
qmake: QT += location
Inherits: QObject

パブリック関数

QPlaceManagerEngine(const QVariantMap &parameters, QObject *parent = nullptr)
virtual ~QPlaceManagerEngine()
virtual QPlaceCategory category(const QString &categoryId) const
virtual QList<QPlaceCategory> childCategories(const QString &parentId) const
virtual QStringList childCategoryIds(const QString &categoryId) const
virtual QPlace compatiblePlace(const QPlace &original) const
virtual QUrl constructIconUrl(const QPlaceIcon &icon, const QSize &size) const
virtual QPlaceContentReply *getPlaceContent(const QPlaceContentRequest &request)
virtual QPlaceDetailsReply *getPlaceDetails(const QString &placeId)
virtual QPlaceReply *initializeCategories()
virtual QList<QLocale> locales() const
QString managerName() const
int managerVersion() const
virtual QPlaceMatchReply *matchingPlaces(const QPlaceMatchRequest &request)
virtual QString parentCategoryId(const QString &categoryId) const
virtual QPlaceIdReply *removeCategory(const QString &categoryId)
virtual QPlaceIdReply *removePlace(const QString &placeId)
virtual QPlaceIdReply *saveCategory(const QPlaceCategory &category, const QString &parentId)
virtual QPlaceIdReply *savePlace(const QPlace &place)
virtual QPlaceSearchReply *search(const QPlaceSearchRequest &request)
virtual QPlaceSearchSuggestionReply *searchSuggestions(const QPlaceSearchRequest &request)
virtual void setLocales(const QList<QLocale> &locales)

シグナル

void categoryAdded(const QPlaceCategory &category, const QString &parentId)
void categoryRemoved(const QString &categoryId, const QString &parentId)
void categoryUpdated(const QPlaceCategory &category, const QString &parentId)
void dataChanged()
void errorOccurred(QPlaceReply *reply, QPlaceReply::Error error, const QString &errorString = QString())
void finished(QPlaceReply *reply)
void placeAdded(const QString &placeId)
void placeRemoved(const QString &placeId)
void placeUpdated(const QString &placeId)

保護された関数

QPlaceManager *manager() const

詳細説明

注意: バックエンドのクラスはソースやバイナリの互換性が保証されていません。APIは開発されたQtのバージョンでのみ動作が保証されています。API の変更はマイナーリリースでのみ行われます。(6.6 や 6.7 など)。

アプリケーション開発者はQPlaceManagerEngineを気にする必要はありません。しかし、バックエンドの実装者はQPlaceManagerEngineから派生し、抽象仮想関数の実装を提供する必要があります。

バックエンドの記述の詳細については、Places Backendドキュメントを参照してください。

QPlaceManagerも参照してください

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

[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(const &icon, const &size).QPlaceIcon QSize

与えられた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() は同時に発生する。

注意: このシグナルに接続されたスロット内のreply オブジェクトを削除しないでください。代わりにdeleteLater() を使用してください。

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

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

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

このシグナルとQPlaceReply::finished() は同時に発せられる。

注意: このシグナルに接続されているスロットのreply オブジェクトを削除しないでください。代わりにdeleteLater() を使用してください。

[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 をマネー ジャ ・ エンジンのデー タ ス ト アに保存 し ます。

request で指定されたパラメーターに従って場所を検索する。

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

request で指定されたパラメータに従って、検索語候補のセットをリクエストする。

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

優先リストの設定locales

locales()も参照のこと

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.