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

Property Documentation

autoColumnCategories : bool

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

Access functions:

Notifier signal:

autoRowCategories : bool

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

Access functions:

Notifier signal:

columnCategories : QStringList

Defines the column categories for the mapping.

Access functions:

Notifier signal:

columnRole : QString

Defines the item model role to map into column category. In addition to defining which column the data belongs to, the value indicated by column role is also set as the X-coordinate value of the QSurfaceDataItem when model data is resolved, unless a separate xPos role is also defined.

Access functions:

Notifier signal:

columnRolePattern : QRegExp

When set, a search and replace is done on the value mapped by 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 columnRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also columnRole and columnRoleReplace.

columnRoleReplace : QString

This property defines the replace content to be used in conjunction with columnRolePattern. Defaults to empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also columnRole and columnRolePattern.

itemModel : QAbstractItemModel *

Defines item model. Does not take ownership of the model, but does connect to it to listen for changes.

Access functions:

Notifier signal:

multiMatchBehavior : MultiMatchBehavior

This property defines how multiple matches for each row/column combination are handled. Defaults to QItemModelSurfaceDataProxy::MMBLast.

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 multiMatchBehavior to QItemModelSurfaceDataProxy::MMBAverage.

Access functions:

Notifier signal:

rowCategories : QStringList

Defines the row categories for the mapping.

Access functions:

Notifier signal:

rowRole : QString

Defines the item model role to map into row category. In addition to defining which row the data belongs to, the value indicated by row role is also set as the Z-coordinate value of the QSurfaceDataItem when model data is resolved, unless a separate zPos role is also defined.

Access functions:

Notifier signal:

rowRolePattern : QRegExp

When set, a search and replace is done on the value mapped by 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 rowRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also rowRole and rowRoleReplace.

rowRoleReplace : QString

This property defines the replace content to be used in conjunction with rowRolePattern. Defaults to empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also rowRole and rowRolePattern.

useModelCategories : bool

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

Defines the item model role to map into X position. If this role is not defined, columnRole is used to determine the X-coordinate value of resolved QSurfaceDataItems.

Access functions:

Notifier signal:

xPosRolePattern : QRegExp

When set, a search and replace is done on the value mapped by xPos role before it is used as a item position value. This property specifies the regular expression to find the portion of the mapped value to replace and xPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also xPosRole and xPosRoleReplace.

xPosRoleReplace : QString

This property defines the replace content to be used in conjunction with xPosRolePattern. Defaults to empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also xPosRole and xPosRolePattern.

yPosRole : QString

Defines the item model role to map into Y position.

Access functions:

Notifier signal:

yPosRolePattern : QRegExp

When set, a search and replace is done on the value mapped by yPos role before it is used as a item position value. This property specifies the regular expression to find the portion of the mapped value to replace and yPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also yPosRole and yPosRoleReplace.

yPosRoleReplace : QString

This property defines the replace content to be used in conjunction with yPosRolePattern. Defaults to empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also yPosRole and yPosRolePattern.

zPosRole : QString

Defines the item model role to map into Z position. If this role is not defined, rowRole is used to determine the Z-coordinate value of resolved QSurfaceDataItems.

Access functions:

Notifier signal:

zPosRolePattern : QRegExp

When set, a search and replace is done on the value mapped by zPos role before it is used as a item position value. This property specifies the regular expression to find the portion of the mapped value to replace and zPosRoleReplace property contains the replacement string.

Access functions:

Notifier signal:

See also zPosRole and zPosRoleReplace.

zPosRoleReplace : QString

This property defines the replace content to be used in conjunction with zPosRolePattern. Defaults to empty string. For more information on how the search and replace using regular expressions works, see QString::replace(const QRegExp &rx, const QString &after) function documentation.

Access functions:

Notifier signal:

See also zPosRole and zPosRolePattern.