CategoryModel QML Type

CategoryModel 型は、Plugin がサポートするカテゴリのモデルを提供します。詳細...

• 継承されたメンバーを含むすべてのメンバーの一覧

プロパティ

• hierarchical : bool
• plugin : Plugin
• status : enumeration

信号

• dataChanged()

方法

• string errorString()

詳細な説明

CategoryModel 型は、現在のPlugin から利用可能なカテゴリのモデルを提供します。このモデルは、カテゴリのフラットなリストと、カテゴリのグループ化を表す階層ツリーの両方をサポートしています。これは、hierarchical プロパティによって制御できます。

このモデルは、以下のロールをサポートしています：

次の例は、利用可能なすべてのカテゴリをフラットなリストとして表示します:

import QtQuick
import QtPositioning
import QtLocation

ListView {
    model: CategoryModel {
        plugin: myPlugin
        hierarchical: false
    }
    delegate: Text { text: category.name }
}

階層的なカテゴリモデルにアクセスするには、DelegateModel を使用して子項目にアクセスする必要があります。

プロパティのドキュメント

hierarchical : bool

このプロパティは、モデルがカテゴリの階層ツリーを提供する場合でも、フラットなリストを提供する場合でも、常に有効です。デフォルト値は true です。

plugin : Plugin

このプロパティには、このモデルで使用されるプロバイダー「Plugin 」が格納されています。

status : enumeration [read-only]

このプロパティはモデルのステータスを保持します。以下のいずれかになります：

信号のドキュメント

dataChanged()

このシグナルは、基となるデータストアに大幅な変更が行われた際に発信されます。

アプリケーションはこのシグナルに対して、独自の判断で対応すべきです。モデルから提供されるデータは古くなっている可能性があるため、いずれはモデルを再更新する必要がありますが、ユーザーが何も操作していないにもかかわらずカテゴリが変更されると、直ちに再更新を行うとユーザーに戸惑いを与える恐れがあります。

対応するハンドラはonDataChanged です。

メソッドのドキュメント

string errorString()

この読み取り専用プロパティには、最新のカテゴリモデルのエラーのテキスト表示が格納されます。エラーが発生していない場合は、空の文字列が返されます。

また、エラーが発生したものの、それに対応するテキスト表現がない場合にも、空の文字列が返されることがあります。