Spec-Zone.ru › Qt 5.15

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

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

Заявление об импорте: import QtLocation 5.15
С: QtLocation 5.5
  • Список всех членов, включая унаследованные

Свойства

  • 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 — это строка, которая однозначно идентифицирует эту категорию внутри плагина плагина категорий.

icon : PlaceIcon

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

name : строка

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

plugin : Плагин

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

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

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

Category.Ready Во время последней операции ошибок не возникло, дальнейшие операции с категорией могут быть выполнены.
Category.Saving Категория в настоящее время сохраняется, никакие другие операции не могут быть выполнены до завершения текущей операции.
Category.Removing Категория в настоящее время удаляется, никакие другие операции не могут быть выполнены до завершения текущей операции.
Category.Error Во время последней операции произошла ошибка, дальнейшие операции с категорией все еще могут быть выполнены.

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

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

Category.UnspecifiedVisibility Видимость категории не определена. При сохранении категории плагин автоматически задаст категорию видимости по умолчанию, сохраненную в бэкенде. Это значение по умолчанию зависит от реализации плагина.
Category.DeviceVisibility Категория ограничена текущим устройством. Категория не будет передана с устройства.
Category.PrivateVisibility Категория является частной для текущего пользователя. Категория может быть передана в онлайн-сервис, но она видна только текущему пользователю.
Category.PublicVisibility Категория общедоступна.

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

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

строка errorString()

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

void remove()

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

void save()

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtlocation-category.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API