Тип QML CategoryModel

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

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

Свойства

• иерархический : bool
• плагин : Plugin
• статус : перечисление

Сигналы

• dataChanged()

Методы

• строка errorString()

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

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

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

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

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 для доступа к дочерним элементам.

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

иерархический : bool

Это свойство указывает, предоставляет ли модель иерархическое дерево категорий или плоский список. По умолчанию значение равно true.

плагин : Plugin

Это свойство содержит используемый поставщик плагин этой модели.

статус : перечисление

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

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

dataChanged()

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

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

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

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

строка errorString() const

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

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