Тип QML CategoryModel

Тип CategoryModel предоставляет модель категорий, поддерживаемых плагином. Подробнее...

• Список всех членов, включая унаследованные члены

Свойства

• hierarchical : bool
• plugin : Plugin
• status : перечисление

Сигналы

• dataChanged()

Методы

• строка errorString()

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

Тип CategoryModel предоставляет модель категорий, доступных от текущего плагина. Модель поддерживает как плоский список категорий, так и иерархическое дерево, представляющее группировку категорий. Это можно контролировать с помощью свойства hierarchical.

Модель поддерживает следующие роли:

Следующий пример отображает плоский список всех доступных категорий:

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 : перечисление

Это свойство содержит состояние модели. Оно может быть одним из следующих:

Документация по сигналам

dataChanged()

Этот сигнал излучается, когда в базовом хранилище данных были внесены существенные изменения.

Приложения должны реагировать на этот сигнал по своему усмотрению. Предоставляемые моделью данные могут быть устаревшими, поэтому модель следует переобновить в какой-то момент, однако немедленное переобновление может быть неудобно для пользователей, если категории изменяются без каких-либо действий с их стороны.

Соответствующий обработчик — onDataChanged.

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

строка errorString() const

Это свойство только для чтения содержит текстовое представление последней ошибки модели категорий. Если ошибка не произошла, возвращается пустая строка.

Пустая строка также может быть возвращена, если произошла ошибка, для которой нет связанного текстового представления.