Класс QItemModelSurfaceDataProxy

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

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

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

Свойства

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

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

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

Сигналы

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

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

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

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

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

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

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

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

• Если свойство useModelCategories установлено в true, этот прокси будет отображать строки и столбцы QAbstractItemModel на строки и столбцы Q3DSurface и использует значение, возвращаемое для Qt::DisplayRole, как Y-координату по умолчанию. Заголовки строк и столбцов используются для Z-координаты и X-координаты по умолчанию, если их можно преобразовать в числа с плавающей точкой. В противном случае используются индексы строк и столбцов. Роль Y-координаты, которую следует использовать, может быть переопределена, если Qt::DisplayRole не подходит. Роли Z-координаты и X-координаты, которые следует использовать, могут быть переопределены, если заголовки или индексы не подходят.
• Для моделей, которые не содержат данные, уже аккуратно отсортированные в строки и столбцы, такие как модели на основе QAbstractListModel, вы можете определить роль от модели для отображения для каждой из строки, столбца и Y-координаты.
• Если вы не хотите включать все данные, содержащиеся в модели, или автоматически сгенерированные строки и столбцы не упорядочены так, как вам нужно, вы можете указать, какие строки и столбцы должны быть включены и в каком порядке, определив явный список категорий для строк или столбцов (или для обоих).

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

QItemModelSurfaceDataProxy *proxy = new QItemModelSurfaceDataProxy(customModel,
                                                                   QStringLiteral("longitude"), // Row role
                                                                   QStringLiteral("latitude"), // Column role
                                                                   QStringLiteral("height")); // Y-position role

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

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

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

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

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

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

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

QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QObject *parent = nullptr)

Создаёт QItemModelSurfaceDataProxy с необязательным parent.

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

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

QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &yPosRole, QObject *parent = nullptr)

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

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

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

QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, QObject *parent = nullptr)

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

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

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

QItemModelSurfaceDataProxy::QItemModelSurfaceDataProxy(QAbstractItemModel *itemModel, const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories, QObject *parent = nullptr)

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

[virtual] QItemModelSurfaceDataProxy::~QItemModelSurfaceDataProxy()

Удаляет QItemModelSurfaceDataProxy.

int QItemModelSurfaceDataProxy::columnCategoryIndex(const QString &category)

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

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

Примечание: Данную функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QItemModelSurfaceDataProxy::remap(const QString &rowRole, const QString &columnRole, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QStringList &rowCategories, const QStringList &columnCategories)

Изменяет rowRole, columnRole, xPosRole, yPosRole, zPosRole, rowCategories и columnCategories в соответствии с отображением.

int QItemModelSurfaceDataProxy::rowCategoryIndex(const QString &category)

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

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

Примечание: Данную функцию можно вызвать через систему метаобъектов и из QML. См. Q_INVOKABLE.

void QItemModelSurfaceDataProxy::setItemModel(QAbstractItemModel *itemModel)

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

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

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