Класс QItemModelScatterDataProxy

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

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

Свойства

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

Сигналы

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

QItemModelScatterDataProxy позволяет использовать модели, производные от QAbstractItemModel, в качестве источника данных для Q3DScatter. Он сопоставляет роли QAbstractItemModel со значениями XYZ точек Q3DScatter.

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

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

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

// Map "density" value to X-axis, "hardness" to Y-axis and "conductivity" to Z-axis.
QItemModelScatterDataProxy *proxy = new QItemModelScatterDataProxy(customModel,
                                                                   QStringLiteral("density"),
                                                                   QStringLiteral("hardness"),
                                                                   QStringLiteral("conductivity"));

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

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

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

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

QItemModelScatterDataProxy::QItemModelScatterDataProxy(QAbstractItemModel *itemModel, const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole, QObject *parent = nullptr)

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

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

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

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

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

QItemModelScatterDataProxy::QItemModelScatterDataProxy(QObject *parent = nullptr)

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

[virtual] QItemModelScatterDataProxy::~QItemModelScatterDataProxy()

Удаляет QItemModelScatterDataProxy.

void QItemModelScatterDataProxy::remap(const QString &xPosRole, const QString &yPosRole, const QString &zPosRole, const QString &rotationRole)

Изменяет сопоставления xPosRole, yPosRole, zPosRole и rotationRole.

void QItemModelScatterDataProxy::setItemModel(QAbstractItemModel *itemModel)

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

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

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