Класс QItemModelBarDataProxy

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

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

Открытые типы

Свойства

• 4 свойства унаследованы от QBarDataProxy
• 1 свойство унаследовано от QAbstractDataProxy
• 1 свойство унаследовано от QObject

Открытые функции

• 28 общедоступных функций, унаследованных от QBarDataProxy
• 1 общедоступная функция, унаследованная от QAbstractDataProxy
• 34 общедоступных функции, унаследованных от QObject

Сигналы

• 10 сигналов, унаследованных от QBarDataProxy
• 2 сигнала, унаследованных от QObject

Дополнительные унаследованные члены

• 1 общедоступный слот, унаследованный от QObject
• 1 общедоступная переменная, унаследованная от QObject
• 10 статических общедоступных членов, унаследованных от QObject
• 9 защищенных функций, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QObject

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

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

QItemModelBarDataProxy позволяет использовать модели, производные от QAbstractItemModel, в качестве источника данных для Q3DBars. Он использует определенные сопоставления для отображения данных из модели в строки, столбцы и значения графика Q3DBars.

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

Сопоставления могут использоваться следующим образом:

• Если свойство useModelCategories установлено в true, этот прокси напрямую сопоставит строки и столбцы QAbstractItemModel со строками и столбцами Q3DBars и по умолчанию использует значение, возвращаемое для Qt::DisplayRole, как значение столбца. Роль значения для использования может быть переопределена, если Qt::DisplayRole не подходит.
• Для моделей, у которых данные не упорядочены в строки и столбцы, например, модели на основе QAbstractListModel, вы можете определить роль из модели для сопоставления каждой из строк, столбцов и значений.
• Если вы не хотите включать все данные, содержащиеся в модели, или автоматически сгенерированные строки и столбцы не упорядочены так, как вам нужно, вы можете указать, какие строки и столбцы следует включить и в каком порядке, определив явный список категорий для строк и/или столбцов.

Например, предположим, что у вас есть пользовательская модель QAbstractItemModel для хранения различных ежемесячных значений, связанных с бизнесом. Каждый элемент в модели имеет роли "год", "месяц", "доход" и "расходы". Вы можете сделать следующее, чтобы отобразить данные на графике столбцами:

// By defining row and column categories, you tell the mapping which row and column each item
// belongs to. The categories must match the data stored in the model in the roles you define
// for row and column mapping. In this example we expect "year" role to return four digit year
// and "month" to return three letter designation for the month.
//
// An example of an item in model would be:
// Requested role -> Returned data
// "year" -> "2006" // Matches the first row category, so this item is added to the first row.
// "month" -> "jan" // Matches the first column category, so this item is added as first item in the row.
// "income" -> "12.1"
// "expenses" -> "9.2"
QStringList years;
QStringList months;
years << "2006" << "2007" << "2008" << "2009" << "2010" << "2011" << "2012";
months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec";

QItemModelBarDataProxy *proxy = new QItemModelBarDataProxy(customModel,
                                                           QStringLiteral("year"), // Row role
                                                           QStringLiteral("month"), // Column role
                                                           QStringLiteral("income"), // Value role
                                                           years, // Row categories
                                                           months); // Column categories

//...

// To display different data later, you can simply change the mapping.
proxy->setValueRole(QStringLiteral("expenses"));

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

Пример использования шаблонов поиска в сочетании с ролями см. на странице Qt Quick 2 Bars Example.

См. также Qt Data Visualization Data Handling.

Документация типов членов

перечисление QItemModelBarDataProxy::MultiMatchBehavior

Типы поведения для свойства QItemModelBarDataProxy::multiMatchBehavior.

Документация по функциям-членам

QItemModelBarDataProxy::QItemModelBarDataProxy(QObject *parent = nullptr)

Конструирует QItemModelBarDataProxy с необязательным parent.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &valueRole, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления. Роль значения устанавливается в valueRole. Этот конструктор предназначен для использования с моделями, данные которых уже правильно отсортированы по строкам и столбцам, поэтому он также устанавливает свойство useModelCategories в значение true.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления. Сопоставления ролей устанавливаются с помощью rowRole, columnRole и valueRole.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления. Сопоставления ролей устанавливаются с помощью rowRole, columnRole, valueRole и rotationRole.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления. Сопоставления ролей устанавливаются с помощью rowRole, columnRole и valueRole. Категории строк и столбцов устанавливаются с помощью rowCategories и columnCategories. Этот конструктор также устанавливает autoRowCategories и autoColumnCategories в значение false.

QItemModelBarDataProxy::QItemModelBarDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

Создаёт QItemModelBarDataProxy с itemModel и необязательным parent. Прокси не принимает во владение itemModel, так как обычно модели элементов принадлежат другим элементам управления. Сопоставления ролей устанавливаются с помощью rowRole, columnRole, valueRole и rotationRole. Категории строк и столбцов устанавливаются с помощью rowCategories и columnCategories. Этот конструктор также устанавливает autoRowCategories и autoColumnCategories в значение false.

[virtual] QItemModelBarDataProxy::~QItemModelBarDataProxy()

Уничтожает QItemModelBarDataProxy.

int QItemModelBarDataProxy::columnCategoryIndex(const QString &category)

Возвращает индекс указанной category в списке категорий столбцов. Если категория не найдена, возвращается -1.

Примечание: Если используется автоматическое создание категорий столбцов, этот метод не вернёт действительный индекс до первого разрешения данных в модели.

Примечание: К этой функции можно обратиться через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QItemModelBarDataProxy::remap(const QString &rowRole, const QString &columnRole, const QString &valueRole, const QString &rotationRole, const QStringList &rowCategories, const QStringList &columnCategories)

Изменяет rowRole, columnRole, valueRole, rotationRole, rowCategories и columnCategories на указанные значения.

int QItemModelBarDataProxy::rowCategoryIndex(const QString &category)

Возвращает индекс указанной category в списке категорий строк. Если список категорий строк пуст, возвращается -1.

Примечание: Если используется автоматическое создание категорий строк, этот метод не вернёт действительный индекс до первого разрешения данных в модели.

Примечание: К этой функции можно обратиться через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QItemModelBarDataProxy::setItemModel(QAbstractItemModel *itemModel)

Устанавливает модель элементов в itemModel. Не принимает во владение модель, но подключается к ней, чтобы отслеживать изменения.

Примечание: Функция-сеттер для свойства itemModel.

См. также itemModel().