Back to Qt.io
Contact Us Blog Download Qt

CategoryModel QML Type

CategoryModel型は、Plugin によってサポートされるカテゴリのモデルを提供する。

Import Statement: import QtLocation 6.8
Since: QtLocation 5.5

プロパティ

シグナル

メソッド

詳細説明

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

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

役割タイプ説明
カテゴリCategory現在のアイテムのカテゴリオブジェクト
親カテゴリCategory現在のアイテムの親カテゴリオブジェクト。親がない場合は、null が返されます。

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

import QtQuick
import QtPositioning
import QtLocation

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

階層化されたカテゴリーモデルにアクセスするには、DelegateModel を使用して子アイテムにアクセスする必要があります。

プロパティ Documentation

hierarchical : bool

このプロパティは、モデルがカテゴリの階層ツリーを提供するか、フラットリストを提供するかを保持します。デフォルトは true です。


plugin : Plugin

このプロパティは、このモデルが使用するプロバイダPlugin を保持します。


status : enumeration [read-only]

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

CategoryModelNullカテゴリ取得クエリが実行されていません。モデルは空です。
CategoryModel.Ready最後の操作中にエラーが発生しなかったため、モデルに対してさらなる操作を実行できます。
CategoryModelロード中モデルは更新中です。完了するまで他の操作は実行できません。
CategoryModelエラー最後の操作中にエラーが発生しました。

シグナル ドキュメント

dataChanged()

このシグナルは、基礎となるデータストアに重大な変更が加えられたときに発行されます。

このシグナルは、アプリケーションの判断で操作してください。モデルによって提供されるデータは古くなっている可能性があるため、モデルはいつか再更新されるべきです。しかし、ユーザが何もしないままカテゴリーが変更された場合、即時の再更新はユーザを不安にさせるかもしれません。

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

注： 対応するハンドラはonDataChanged 。


メソッド文書

string errorString()

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

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


本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。