Spec-Zone.ru › Qt 5.15

Тип QML CategoryModel

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

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

Свойства

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

Сигналы

  • dataChanged()

Методы

  • строка errorString()

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

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

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

Роль Тип Описание
категория Category Объект категории для текущего элемента.
родительскаяКатегория 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 для доступа к дочерним элементам.

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

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

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

плагин : Plugin

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

состояние : перечисление

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

CategoryModel.Null Запрос на загрузку категорий не был выполнен. Модель пуста.
CategoryModel.Ready Во время последней операции не возникло ошибок, на модели можно выполнять дальнейшие операции.
CategoryModel.Loading Модель обновляется, другие операции нельзя выполнять до завершения.
CategoryModel.Error Во время последней операции произошла ошибка, на модели все еще можно выполнять дальнейшие операции.

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

dataChanged()

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

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

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

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

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

строка errorString()

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

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

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qml-qtlocation-categorymodel.html

Spec-Zone.ru

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