Тип QML ItemModelSurfaceDataProxy

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

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

Свойства

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : список<Строка>
• columnRole : строка
• columnRolePattern : regExp
• columnRoleReplace : строка
• itemModel : модель
• multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior
• rowCategories : список<Строка>
• rowRole : строка
• rowRolePattern : regExp
• rowRoleReplace : строка
• useModelCategories : bool
• xPosRole : строка
• xPosRolePattern : regExp
• xPosRoleReplace : строка
• yPosRole : строка
• yPosRolePattern : regExp
• yPosRoleReplace : строка
• zPosRole : строка
• zPosRolePattern : regExp
• zPosRoleReplace : строка

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

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

Данные разрешаются асинхронно всякий раз, когда изменяется отображение или модель.

Для перечислений ItemModelSurfaceDataProxy см. QItemModelSurfaceDataProxy::MultiMatchBehavior.

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

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

ItemModelSurfaceDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing population data.
    // Mapping model roles to surface series rows, columns, and values.
    rowRole: "longitude"
    columnRole: "latitude"
    valueRole: "pop_density"
}

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

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

autoColumnCategories : bool

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

autoRowCategories : bool

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

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

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

columnRole : строка

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

columnRolePattern : regExp

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

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

columnRoleReplace : строка

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

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

itemModel : модель

Модель элементов, используемая в качестве источника данных для Surface3D.

multiMatchBehavior : ItemModelSurfaceDataProxy.MultiMatchBehavior

Определяет, как обрабатываются несколько совпадений для каждой комбинации строк/столбцов. По умолчанию ItemModelSurfaceDataProxy.MMBLast.

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

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

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

rowRole : строка

Роль модели элемента для сопоставления с категорией строки. В дополнение к определению строки, к которой относятся данные, значение, указанное ролью строки, также устанавливается в качестве значения координаты Z QSurfaceDataItem при разрешении данных модели, если не определена отдельная роль координаты z.

rowRolePattern : regExp

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

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

rowRoleReplace : строка

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

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

useModelCategories : bool

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

xPosRole : string

Роль элемента модели, которая отображается в X-координате. Если эта роль не определена, используется columnRole для определения значения X-координаты разрешенных QSurfaceDataItem элементов.

xPosRolePattern : regExp

При установке выполняется поиск и замена значения, сопоставленного с ролью X-позиции, перед использованием его в качестве значения позиции элемента. Данное свойство определяет регулярное выражение для поиска части значения, подлежащей замене, а свойство xPosRoleReplace содержит строку замены.

См. также xPosRole и xPosRoleReplace.

xPosRoleReplace : string

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

См. также xPosRole и xPosRolePattern.

yPosRole : string

Роль элемента модели, отображаемая в Y-координате.

yPosRolePattern : regExp

При установке выполняется поиск и замена значения, сопоставленного с ролью Y-позиции, перед использованием его в качестве значения позиции элемента. Данное свойство определяет регулярное выражение для поиска части значения, подлежащей замене, а свойство yPosRoleReplace содержит строку замены.

См. также yPosRole и yPosRoleReplace.

yPosRoleReplace : string

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

См. также yPosRole и yPosRolePattern.

zPosRole : string

Роль элемента модели, которая отображается в Z-координате. Если эта роль не определена, используется rowRole для определения значения Z-координаты разрешенных QSurfaceDataItem элементов.

zPosRolePattern : regExp

При установке выполняется поиск и замена значения, сопоставленного с ролью Z-позиции, перед использованием его в качестве значения позиции элемента. Данное свойство определяет регулярное выражение для поиска части значения, подлежащей замене, а свойство zPosRoleReplace содержит строку замены.

См. также zPosRole и zPosRoleReplace.

zPosRoleReplace : string

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

См. также zPosRole и zPosRolePattern.