Тип QML CategoryModel
Тип CategoryModel предоставляет модель категорий, поддерживаемых плагином. Подробнее...
| Заявление об импорте: | import QtLocation 5.14 |
| С момента: | QtLocation 5.5 |
Свойства
- hierarchical : bool
- plugin : Plugin
- status : перечисление
Сигналы
Методы
- строка errorString()
Подробное описание
Тип CategoryModel предоставляет модель категорий, доступных из текущего плагина. Модель поддерживает как плоский список категорий, так и иерархическое дерево, представляющее группировки категорий. Это можно контролировать с помощью свойства hierarchical.
Модель поддерживает следующие роли:
| Роль | Тип | Описание |
|---|---|---|
| category | Category | Объект категории для текущего элемента. |
| parentCategory | Category | Объект родительской категории для текущего элемента. Если родитель отсутствует, возвращается null. |
Следующий пример отображает плоский список всех доступных категорий:
import QtQuick 2.0
import QtPositioning 5.5
import QtLocation 5.6
ListView {
model: CategoryModel {
plugin: myPlugin
hierarchical: false
}
delegate: Text { text: category.name }
} Для доступа к иерархической модели категорий необходимо использовать DelegateModel для доступа к дочерним элементам.
Документация по свойствам
hierarchical : bool
Это свойство указывает, предоставляет ли модель иерархическое дерево категорий или плоский список. По умолчанию значение — true.
plugin : Plugin
Это свойство содержит используемый плагин поставщика.
status : перечисление
Это свойство содержит состояние модели. Оно может быть одним из:
| CategoryModel.Null | Запрос на получение категорий не был выполнен. Модель пуста. |
| CategoryModel.Ready | Во время последней операции ошибок не произошло, на модели можно выполнять дальнейшие операции. |
| CategoryModel.Loading | Модель обновляется, другие операции нельзя выполнять до завершения. |
| CategoryModel.Error | Во время последней операции произошла ошибка, на модели все еще можно выполнять дальнейшие операции. |
Документация по сигналам
dataChanged()
Этот сигнал излучается, когда были внесены существенные изменения в базу данных.
Приложения должны реагировать на этот сигнал по своему усмотрению. Предоставляемые моделью данные могут быть устаревшими, поэтому модель следует обновить, но немедленное обновление может быть неудобно для пользователей, если категории изменяются без их действий.
Соответствующий обработчик — onDataChanged.
Документация по методам
строка errorString()
Это свойство только для чтения содержит текстовое представление последней ошибки модели категорий. Если ошибок не было, возвращается пустая строка.
Пустая строка также может быть возвращена, если произошла ошибка, у которой нет связанного текстового представления.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qml-qtlocation-categorymodel.html