Spec-Zone.ru › Qt 5.11

Тип QML CategoryModel

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

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

Свойства

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

Сигналы

  • dataChanged()

Методы

  • строка 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/archives/qt-5.11/qml-qtlocation-categorymodel.html

Spec-Zone.ru

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