分类 QML 类型

Category 类型表示一个 Place 可以与之关联的分类。更多信息...

导入语句	import QtLocation 6.7
自	QtLocation 5.5

所有成员列表，包括继承的成员

属性

categoryId : string
icon : PlaceIcon
name : string
plugin : Plugin
status : enumeration
visibility : enumeration

方法

string errorString()
void remove()
void save()

详细描述

分类用于根据 Place 关联的分类进行搜索。可用的分类列表可以从 CategoryModel 获取。 PlaceSearchModel 中有一个 categories 属性，用于将搜索结果限制为具有指定分类的 Place。

如果 Plugin 支持，可以创建或删除分类。要创建一个新的分类，构造一个新的 Category 对象并设置其属性，然后调用 save() 方法。

import QtPositioning
import QtLocation

Category {
    id: category

    plugin: myPlugin
    name: "New Category"
    visibility: Category.PrivateVisibility
}
...
category.save();

要删除一个分类，确保已经设置了 plugin 和 categoryId 属性，然后调用 remove() 方法。

另请参阅 CategoryModel。

属性文档

categoryId : string

此属性保留分类的标识符。categoryId 是一个字符串，它在plugin中的分类中唯一标识此分类。

icon : PlaceIcon

此属性保留与分类关联的图像来源。要显示图标，您可以使用 Image 类型。

name : string

此属性保留基于字符串的分类名称。

plugin : Plugin

此属性保留属于位置型服务的分类。

status : enumeration [只读]

该属性存储类别的状态。它可以取以下之一

Category.Ready	上一次操作没有出错，可以继续对其进行其他操作。
Category.Saving	类别当前正在保存中，其他操作将在当前操作完成后才能执行。
Category.Removing	类别当前正在删除中，其他操作将在当前操作完成后才能执行。
Category.Error	上一次操作出现错误，但依然可以继续对类别进行其他操作。

可见性 : 枚举

该属性存储类别的可见性。它可以取以下之一

Category.UnspecifiedVisibility	类别的可见性未指定。如果保存类别，插件将自动设置一个默认可见性用于后端保存的类别。这个默认值取决于插件实现。
Category.DeviceVisibility	类别仅限于当前设备。类别不会被转移到设备外部。
Category.PrivateVisibility	该类别仅对当前用户私密。该类别可以传输到在线服务，但只能对当前用户可见。
Category.PublicVisibility	该类别是公开的。

请注意，可见性不会影响与该类别关联的地点在设备应用程序用户界面中的显示方式。它定义了类别的共享语义。

方法文档

string errorString()

返回上一次操作的错误描述字符串。如果上一次操作成功完成，则字符串为空。

void remove()

此方法将从后端服务永久删除类别。

void save()

此方法将类别保存到后端服务。