QItemModelSurfaceDataProxy Class

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

Property Documentation

autoColumnCategories : bool

This property holds whether column categories are generated automatically.

When set to true, the mapping ignores any explicitly set column categories and overwrites them with automatically generated ones whenever the data from the model is resolved. Defaults to true.

Access functions:

Notifier signal:

autoRowCategories : bool

This property holds whether row categories are generated automatically.

When set to true, the mapping ignores any explicitly set row categories and overwrites them with automatically generated ones whenever the data from the model is resolved. Defaults to true.

Access functions:

Notifier signal:

columnCategories : QStringList

This property holds the column categories for the mapping.

Access functions:

Notifier signal:

columnRole : QString

This property holds the item model role to map to the column category.

In addition to defining which column the data belongs to, the value indicated by the column role is also set as the X-coordinate value of QSurfaceDataItem when model data is resolved, unless a separate x-position role is also defined.

Access functions:

Notifier signal:

columnRolePattern : QRegularExpression

This property holds whether a search and replace is done on the value mapped by the column role before it is used as a column category.

This property specifies the regular expression to find the portion of the mapped value to replace and the columnRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also columnRole and columnRoleReplace.

columnRoleReplace : QString

This property holds the replacement content to be used in conjunction with a column role pattern.

Defaults to an empty string. For more information on how the search and replace using regular expressions works, see the QString::replace(const QRegularExpression &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also columnRole and columnRolePattern.

itemModel : QAbstractItemModel*

This property holds the item model used as a data source for the 3D surface.

Access functions:

Notifier signal:

multiMatchBehavior : QItemModelSurfaceDataProxy::MultiMatchBehavior

How multiple matches for each row/column combination are handled.

Defaults to Last.

For example, you might have an item model with timestamped data taken at irregular intervals and you want to visualize an average position of data items on each hour with a surface graph. This can be done by specifying row and column categories so that each surface point represents an hour, and setting this property to Average.

Access functions:

Notifier signal:

rowCategories : QStringList

This property holds the row categories for the mapping.

Access functions:

Notifier signal:

rowRole : QString

This property holds the item model role to map to the row category.

In addition to defining which row the data belongs to, the value indicated by the row role is also set as the Z-coordinate value of QSurfaceDataItem when model data is resolved, unless a separate z-position role is also defined.

Access functions:

Notifier signal:

rowRolePattern : QRegularExpression

This property holds whether a search and replace is performed on the value mapped by the row role before it is used as a row category.

This property specifies the regular expression to find the portion of the mapped value to replace and the rowRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also rowRole and rowRoleReplace.

rowRoleReplace : QString

This property holds the replacement content to be used in conjunction with the row role pattern.

Defaults to an empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegularExpression &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also rowRole and rowRolePattern.

useModelCategories : bool

This property holds whether row and column roles and categories are used for mapping.

When set to true, the mapping ignores row and column roles and categories, and uses the rows and columns from the model instead. Defaults to false.

Access functions:

Notifier signal:

xPosRole : QString

This property holds the item model role to map to the X position.

If this role is not defined, columnRole is used to determine the X-coordinate value of the resolved QSurfaceDataItem objects.

Access functions:

Notifier signal:

xPosRolePattern : QRegularExpression

This property holds whether a search and replace is done on the value mapped by the x position role before it is used as an item position value.

This property specifies the regular expression to find the portion of the mapped value to replace and the xPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also xPosRole and xPosRoleReplace.

xPosRoleReplace : QString

This property holds the replacement content to be used in conjunction with an x position role pattern.

Defaults to an empty string. For more information on how the search and replace using regular expressions works, see the QString::replace(const QRegularExpression &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also xPosRole and xPosRolePattern.

yPosRole : QString

This property holds the item model role to map to the Y position.

Access functions:

Notifier signal:

yPosRolePattern : QRegularExpression

This property holds whether a search and replace is done on the value mapped by the y position role before it is used as an item position value.

This property specifies the regular expression to find the portion of the mapped value to replace and the yPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also yPosRole and yPosRoleReplace.

yPosRoleReplace : QString

This property holds the replacement content to be used in conjunction with an y position role pattern.

Defaults to an empty string. For more information on how the search and replace using regular expressions works, see the QString::replace(const QRegularExpression &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also yPosRole and yPosRolePattern.

zPosRole : QString

This property holds the item model role to map to the Z position.

If this role is not defined, rowRole is used to determine the Z-coordinate value of resolved QSurfaceDataItem objects.

Access functions:

Notifier signal:

zPosRolePattern : QRegularExpression

This property holds whether a search and replace is done on the value mapped by the z position role before it is used as an item position value.

This property specifies the regular expression to find the portion of the mapped value to replace and the zPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also zPosRole and zPosRoleReplace.

zPosRoleReplace : QString

This property holds the replacement content to be used in conjunction with a z position role pattern.

Defaults to an empty string. For more information on how the search and replace using regular expressions works, see the QString::replace(const QRegularExpression &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also zPosRole and zPosRolePattern.