Spec-Zone.ru › Qt 5.14

Тип QML Категория

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

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

Свойства

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

Методы

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

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

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

Если Плагин поддерживает это, категории могут быть созданы или удалены. Для создания новой категории необходимо создать новый объект 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 Категория является общедоступной.

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

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

строка 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.14/qml-qtlocation-category.html

Spec-Zone.ru

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