Spec-Zone.ru › Qt 5.11

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

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

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

Свойства

  • category : QPlaceCategory
  • categoryId : строка
  • icon : PlaceIcon
  • name : строка
  • plugin : 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 : 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/archives/qt-5.11/qml-qtlocation-category.html

Spec-Zone.ru

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