Тип QML категории

Тип категории представляет категорию, к которой может быть привязан объект Place. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• category : QPlaceCategory
• categoryId : строка
• icon : PlaceIcon
• name : строка
• plugin : Плагин
• status : перечисление
• visibility : перечисление

Методы

• строка errorString()
• void remove()
• void save()

Подробное описание

Категории используются для поиска мест на основе связанных с ними категорий. Список доступных категорий можно получить из CategoryModel. PlaceSearchModel имеет свойство categories, которое используется для ограничения результатов поиска местами с указанными категориями.

Если плагин это поддерживает, категории можно создавать или удалять. Чтобы создать новую категорию, создайте новый объект Category и установите его свойства, а затем вызовите метод save().

import QtPositioning 5.5
import QtLocation 5.6

Category {
    id: category

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

Чтобы удалить категорию, убедитесь, что свойства плагина и categoryId установлены, и вызовите метод remove().

См. также CategoryModel.

Документация по свойствам

category : QPlaceCategory

Подробные сведения о том, как использовать это свойство для взаимодействия между C++ и QML, см. в разделе "Взаимодействие между C++ и QML-кодом".

categoryId : строка

Это свойство содержит идентификатор категории. categoryId — это строка, которая однозначно идентифицирует эту категорию в пределах плагина категорий plugin.

icon : PlaceIcon

Это свойство содержит источник изображения, связанный с категорией. Чтобы отобразить значок, можно использовать тип Image.

name : строка

Это свойство содержит строковое имя категории.

plugin : Плагин

Это свойство содержит службу на основе местоположения, к которой принадлежит категория.

status : перечисление

Это свойство содержит состояние категории. Оно может быть одним из следующих:

visibility : перечисление

Это свойство содержит видимость категории. Оно может быть одним из следующих:

Обратите внимание, что видимость не влияет на то, как объекты Place, связанные с категорией, отображаются в пользовательском интерфейсе приложения на устройстве. Вместо этого она определяет семантику совместного использования категории.

Документация по методам

строка errorString()

Возвращает строку, описывающую ошибку последней операции. Если последняя операция выполнилась успешно, строка пустая.

void remove()

Этот метод постоянно удаляет категорию из службы бэкенда.

void save()

Этот метод сохраняет категорию в службе бэкенда.