Category QML Type

类别类型表示Place 可以关联的类别。更多

Import Statement:	`import QtLocation 6.9`
Since:	QtLocation 5.5

所有成员（包括继承成员）的列表

属性

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

方法

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

详细说明

类别用于根据与之相关的类别搜索地点。可用类别列表可从CategoryModel 获取。PlaceSearchModel 有一个categories 属性，用于将搜索结果限制为具有指定类别的地点。

如果Plugin 支持，则可以创建或删除类别。要创建一个新类别，需要构建一个新的类别对象并设置其属性，然后调用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

该属性包含与类别相关联的图片源。要显示图标，可以使用图像类型。

name : string

该属性包含基于字符串的类别名称。

plugin : Plugin

该属性包含类别所属的基于位置的服务。

status : enumeration [read-only]

该属性显示类别的状态。可以是

类别.就绪	上次操作未发生错误，可对类别执行进一步操作。
类别.正在保存	当前正在保存类别，在当前操作完成前不得执行其他操作。
类别删除	当前正在删除类别，在当前操作完成之前不能执行其他操作。
类别错误	上次操作过程中发生错误，但仍可对该类别执行其他操作。

visibility : enumeration

该属性表示类别的可见性。它可以是

Category.UnspecifiedVisibility	类别的可见性未指明。如果保存类别，插件会自动将默认可见性设置为保存在后台的类别。该默认值取决于插件的实现。
类别设备可见性	类别仅限于当前设备。类别不会从设备上转移。
类别私有可见性	该类别对当前用户不公开。类别可以转移到在线服务，但只有当前用户可见。
类别公开可见性	类别是公开的。

请注意，可见性并不影响与类别相关的Place在设备上应用程序的用户界面中的显示方式。相反，它定义了类别的共享语义。

方法文档

string errorString()

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

void remove()

本方法从后台服务中永久删除类别。

void save()

本方法将类别保存到后台服务。

© 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.