Spec-Zone.ru › Qt 5.13

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

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

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

Свойства

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

Методы

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

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

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

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

import QtPositioning 5.5
import QtLocation 5.6

Category {
    id: category

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

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

См. также CategoryModel.

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

category : QPlaceCategory

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

categoryId : строка

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

icon : PlaceIcon

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

name : строка

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

plugin : 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.13/qml-qtlocation-category.html

Spec-Zone.ru

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