CategoryModel QML Type
CategoryModel型は、Plugin によってサポートされるカテゴリのモデルを提供する。
| Import Statement: | import QtLocation 6.8 |
| Since: | QtLocation 5.5 |
プロパティ
- hierarchical : bool
- plugin : Plugin
- status : enumeration
信号
方法
- string errorString()
詳細な説明
CategoryModel 型は、現在のPlugin から利用可能なカテゴリのモデルを提供します。このモデルは、カテゴリのフラットリストと、カテゴリのグループ化を表す階層ツリーの両方をサポートしています。これは、hierarchical プロパティによって制御できます。
このモデルは以下のロールをサポートします：
次の例は、利用可能なすべてのカテゴリのフラットリストを表示します：
import QtQuick import QtPositioning import QtLocation ListView { model: CategoryModel { plugin: myPlugin hierarchical: false } delegate: Text { text: category.name } }
階層化されたカテゴリーモデルにアクセスするには、DelegateModel を使用して子アイテムにアクセスする必要があります。
プロパティ Documentation
hierarchical : bool |
このプロパティは、モデルがカテゴリの階層ツリーを提供するか、フラットリストを提供するかを保持します。デフォルトは true です。
status : enumeration |
このプロパティは、モデルの状態を保持します。以下のいずれかになります：
| CategoryModelNull | カテゴリ取得クエリが実行されていません。モデルは空です。 |
| CategoryModel.Ready | 最後の操作中にエラーが発生しなかったため、モデルに対してさらなる操作を実行できます。 |
| CategoryModelロード中 | モデルは更新中です。完了するまで他の操作は実行できません。 |
| CategoryModelエラー | 最後の操作中にエラーが発生しました。 |
シグナル ドキュメント
dataChanged() |
このシグナルは、基礎となるデータストアに重大な変更が加えられたときに発行されます。
このシグナルは、アプリケーションの判断で操作してください。モデルによって提供されるデータは古くなっている可能性があるため、モデルはいつか再更新されるべきです。しかし、ユーザが何もしないままカテゴリーが変更された場合、すぐに再更新されるとユーザを不安にさせるかもしれません。
対応するハンドラはonDataChanged です。
注： 対応するハンドラはonDataChanged 。
メソッド文書
string errorString() |
この読み取り専用プロパティは、最新のカテゴリーモデルエラーのテキスト表示を保持する。エラーが発生していない場合は、空の文字列が返されます。
関連するテキスト表現を持たないエラーが発生した場合も、空の文字列が返されることがあります。
© 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.
