Тип QML ItemModelBarDataProxy

Класс-прокси для представления данных в моделях элементов с Bars3D. Подробнее...

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

Свойства

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : список<Строка>
• columnRole : строка
• columnRolePattern : regExp
• columnRoleReplace : строка
• itemModel : модель
• multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior
• rotationRole : строка
• rotationRolePattern : regExp
• rotationRoleReplace : строка
• rowCategories : список<Строка>
• rowRole : строка
• rowRolePattern : regExp
• rowRoleReplace : строка
• useModelCategories : bool
• valueRole : строка
• valueRolePattern : regExp
• valueRoleReplace : строка

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

Этот тип позволяет вам использовать модели, производные от AbstractItemModel, в качестве источника данных для Bars3D.

Данные разрешаются асинхронно всякий раз, когда изменяется отображение или модель. QBarDataProxy::arrayReset() излучается, когда данные были разрешены.

Для перечислений ItemModelBarDataProxy см. QItemModelBarDataProxy::MultiMatchBehavior.

Для получения более подробной информации см. документацию QItemModelBarDataProxy.

Пример использования:

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

См. также BarDataProxy и Обработка данных Qt Data Visualization.

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

autoColumnCategories : bool

Если установлено значение true, отображение игнорирует все явно заданные категории столбцов и перезаписывает их автоматически сгенерированными значениями всякий раз, когда данные из модели разрешаются. Значение по умолчанию true.

autoRowCategories : bool

Если установлено значение true, отображение игнорирует все явно заданные категории строк и перезаписывает их автоматически сгенерированными значениями всякий раз, когда данные из модели разрешаются. Значение по умолчанию true.

columnCategories : список<Строка>

Категории столбцов отображения. В разрешение данных включаются только элементы со значениями роли столбца, которые находятся в этом списке. Столбцы упорядочены в том же порядке, что и в этом списке.

columnRole : строка

Роль модели элементов для отображения в категории столбца.

columnRolePattern : regExp

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

См. также columnRole и columnRoleReplace.

columnRoleReplace : строка

Это свойство определяет заменяемое содержимое, которое используется в сочетании с columnRolePattern. Значение по умолчанию — пустая строка. Для получения дополнительной информации о том, как работает поиск и замена с помощью регулярных выражений, см. документацию функции QString::replace(const QRegExp &rx, const QString &after).

См. также columnRole и columnRolePattern.

itemModel : модель

Модель элементов.

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

Определяет, как обрабатываются несколько совпадений для каждой комбинации строк/столбцов. Значение по умолчанию — ItemModelBarDataProxy.MMBLast. Выбранное поведение влияет как на значение столбца, так и на его поворот.

Например, у вас может быть модель элементов со временными данными, взятыми с нерегулярными интервалами, и вы хотите визуализировать общую сумму данных по каждому дню с помощью столбчатой диаграммы. Это можно сделать, указав категории строк и столбцов таким образом, чтобы каждый столбец представлял день, и задав multiMatchBehavior значением ItemModelBarDataProxy.MMBCumulative.

rotationRole : строка

Роль модели элементов для отображения угла поворота столбца.

rotationRolePattern : regExp

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

См. также rotationRole и rotationRoleReplace.

rotationRoleReplace : строка

Это свойство определяет заменяемое содержимое, которое используется в сочетании с rotationRolePattern. Значение по умолчанию — пустая строка. Для получения дополнительной информации о том, как работает поиск и замена с помощью регулярных выражений, см. документацию функции QString::replace(const QRegExp &rx, const QString &after).

См. также rotationRole и rotationRolePattern.

rowCategories : список<Строка>

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

rowRole : строка

Роль модели элементов для отображения в категории строки.

rowRolePattern : regExp

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

См. также rowRole и rowRoleReplace.

rowRoleReplace : string

Это свойство определяет содержимое для замены, используемое совместно с rowRolePattern. По умолчанию пустая строка. Дополнительную информацию о том, как работает поиск и замена с использованием регулярных выражений, см. в документации функции QString::replace(const QRegExp &rx, const QString &after).

См. также rowRole и rowRolePattern.

useModelCategories : bool

При установке в true, отображение игнорирует роли строк и столбцов, а также категории и использует строки и столбцы из модели вместо этого. Заголовки строк и столбцов используются в качестве меток строк и столбцов. По умолчанию false.

valueRole : string

Роль элемента модели, отображаемая в качестве значения столбца.

valueRolePattern : regExp

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

См. также valueRole и valueRoleReplace.

valueRoleReplace : string

Это свойство определяет содержимое для замены, используемое совместно с valueRolePattern. По умолчанию пустая строка. Дополнительную информацию о том, как работает поиск и замена с использованием регулярных выражений, см. в документации функции QString::replace(const QRegExp &rx, const QString &after).

См. также valueRole и valueRolePattern.