Класс QItemModelScatterDataProxy

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

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

Свойства

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

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

• 12 открытых функций унаследованы от QScatterDataProxy
• 1 открытая функция унаследована от QAbstractDataProxy
• 34 открытых функции унаследованы от QObject

Сигналы

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

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

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

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

Класс-прокси для представления данных в моделях элементов с 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 QRegExp &rx, const QString &after). Обратите внимание, что использование регулярных выражений влияет на производительность, поэтому более эффективно использовать модели элементов, где поиск и замена не нужны для получения необходимых значений.

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

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

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

QItemModelScatterDataProxy::QItemModelScatterDataProxy(QObject *parent = nullptr)

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

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

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

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, 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.

[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().