CategoryModel QML 类型

CategoryModel 类型提供了一个模型，表示由插件支持的类别。更多...

导入语句	import QtLocation 6.7
自	QtLocation 5.5

包括继承成员在内的所有成员列表

属性

hierarchical : bool
plugin : Plugin
status : enumeration

信号

dataChanged()

方法

string errorString()

详细描述

CategoryModel 类型提供了一个表示当前插件可用类别的模型。模型支持类别平列表和表示类别分组的层次树。这可以通过 hierarchical 属性来控制。

模型支持以下角色

角色	类型	描述
category	类别	当前项的类别对象。
parentCategory	类别	当前项的父类别对象。如果没有父类别，则返回 null。

以下示例显示所有可用的类别平列表：

import QtQuick
import QtPositioning
import QtLocation

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

要访问层次类别模型，需要使用 DelegateModel 来访问子项。

属性说明

hierarchical : bool

此属性表示模型是否提供类别的层次树或平列表。默认值为 true。

plugin : Plugin

此属性表示模型使用的插件。

status : enumeration [只读]

此属性表示模型的状态。它可以是一下中的一个：

CategoryModel.Null	没有任何类别获取查询被执行。模型为空。
CategoryModel.Ready	在上次操作期间没有发生错误，可以继续在模型上执行操作。
CategoryModel.Loading	模型正在更新，完成之前不允许执行其他操作。
CategoryModel.Error	上次操作过程中发生了错误，但仍可以在模型上执行其他操作。

信号文档

dataChanged()

当底层数据存储库发生重大更改时，会发出此信号。

应用程序应根据其自身判断来处理此信号。模型提供的数据可能已过时，因此模型可能需要在某个时间重新更新，但如果没有采取任何行动立即重新更新可能会使用户感到困惑。

相应的处理程序是 onDataChanged。

注意：相应的处理程序是 onDataChanged。

方法文档

string errorString()

这个只读属性包含最新分类模型错误的文本表示。如果没有发生错误，将返回空字符串。

如果发生了没有相关文本表示的错误，也可能返回空字符串。