ItemModelSurfaceDataProxy QML Type

Proxy class for presenting data in item models with Surface3D . 更多...

import 语句：	`import QtGraphs`
在 C++：	QItemModelSurfaceDataProxy
继承：	SurfaceDataProxy

所有成员列表，包括继承成员
ItemModelSurfaceDataProxy is part of Qt Graphs QML Types for 3D .

特性

autoColumnCategories : bool
autoRowCategories : bool
columnCategories : list<String>
columnRole : string
columnRolePattern : regExp
columnRoleReplace : string
itemModel : model
multiMatchBehavior : enumeration
rowCategories : list<String>
rowRole : string
rowRolePattern : regExp
rowRoleReplace : string
type : AbstractDataProxy.DataType
useModelCategories : bool
xPosRole : string
xPosRolePattern : regExp
xPosRoleReplace : string
yPosRole : string
yPosRolePattern : regExp
yPosRoleReplace : string
zPosRole : string
zPosRolePattern : regExp
zPosRoleReplace : string

信号

autoColumnCategoriesChanged (bool enable )
autoRowCategoriesChanged (bool enable )
columnCategoriesChanged ()
columnRoleChanged (string role )
columnRolePatternChanged (regExp pattern )
columnRoleReplaceChanged (string replace )
itemModelChanged (model itemModel )
multiMatchBehaviorChanged (enumeration behavior )
rowCategoriesChanged ()
rowRoleChanged (string role )
rowRolePatternChanged (regExp pattern )
rowRoleReplaceChanged (string replace )
useModelCategoriesChanged (bool enable )
xPosRoleChanged (string role )
xPosRolePatternChanged (regExp pattern )
xPosRoleReplaceChanged (string replace )
yPosRoleChanged (string role )
yPosRolePatternChanged (regExp pattern )
yPosRoleReplaceChanged (string replace )
zPosRoleChanged (string role )
zPosRolePatternChanged (regExp pattern )
zPosRoleReplaceChanged (string replace )

详细描述

This type allows you to use AbstractItemModel derived models as a data source for Surface3D .

Data is resolved asynchronously whenever the mapping or the model changes.

For ItemModelSurfaceDataProxy enums, see 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 and Qt Graphs Data Handling with 3D .

特性文档编制

autoColumnCategories : bool

当设为 true , the mapping ignores any explicitly set column categories and overwrites them with automatically generated ones whenever the data from the model is resolved. Proxy minimum and maximum column values are also autogenerated from the data when this is set to true 。默认为 true .

autoRowCategories : bool

当设为 true , the mapping ignores any explicitly set row categories and overwrites them with automatically generated ones whenever the data from the model is resolved. Proxy minimum and maximum row values are also autogenerated from the data when this is set to true 。默认为 true .

columnCategories : list < 字符串 >

The column categories of the mapping. Only items with column roles that are found in this list are included when data is resolved. The columns are ordered in the same order as they are in this list.

columnRole : string

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 the model data is resolved, unless a separate x position role is also defined.

columnRolePattern : regExp

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

另请参阅 columnRole and columnRoleReplace .

columnRoleReplace : string

The replacement content to be used in conjunction with columnRolePattern . 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.

另请参阅 columnRole and columnRolePattern .

itemModel : model

The item model used as a data source for Surface3D .

multiMatchBehavior : enumeration

Defines how multiple matches for each row/column combination are handled. Defaults to ItemModelSurfaceDataProxy.MultiMatchBehavior.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 multiMatchBehavior to ItemModelSurfaceDataProxy.MultiMatchBehavior.Average .

rowCategories : list < 字符串 >

The row categories of the mapping. Only items with row roles that are found in this list are included when data is resolved. The rows are ordered in the same order as they are in this list.

rowRole : string

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 the model data is resolved, unless a separate z position role is also defined.

rowRolePattern : regExp

When set, a search and replace is done 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.

另请参阅 rowRole and rowRoleReplace .

rowRoleReplace : string

The replacement content to be used in conjunction with rowRolePattern . 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.

另请参阅 rowRole and rowRolePattern .

type : AbstractDataProxy . DataType [read-only]

The type of the proxy. One of the QAbstractDataProxy::DataType 值。

useModelCategories : bool

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

xPosRole : string

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 项。

xPosRolePattern : regExp

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

另请参阅 xPosRole and xPosRoleReplace .

xPosRoleReplace : string

The replacement content to be used in conjunction with xPosRolePattern . 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.

另请参阅 xPosRole and xPosRolePattern .

yPosRole : string

The item model role to map to the Y position.

yPosRolePattern : regExp

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

另请参阅 yPosRole and yPosRoleReplace .

yPosRoleReplace : string

The replacement content to be used in conjunction with yPosRolePattern . 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.

另请参阅 yPosRole and yPosRolePattern .

zPosRole : string

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 the resolved QSurfaceDataItem 项。

zPosRolePattern : regExp

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

另请参阅 zPosRole and zPosRoleReplace .

zPosRoleReplace : string

The replacement content to be used in conjunction with zPosRolePattern . 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.

另请参阅 zPosRole and zPosRolePattern .

信号文档编制

autoColumnCategoriesChanged ( bool enable )

此信号发射，当 autoColumnCategories changes to enable .

注意： 相应处理程序是 onAutoColumnCategoriesChanged .

autoRowCategoriesChanged ( bool enable )

此信号发射，当 autoRowCategories changes to enable .

注意： 相应处理程序是 onAutoRowCategoriesChanged .

columnCategoriesChanged ()

此信号发射，当 columnCategories 改变。

注意： 相应处理程序是 onColumnCategoriesChanged .

columnRoleChanged ( string role )

此信号发射，当 columnRole changes to role .

注意： 相应处理程序是 onColumnRoleChanged .

columnRolePatternChanged ( regExp pattern )

此信号发射，当 columnRolePattern changes to pattern .

注意： 相应处理程序是 onColumnRolePatternChanged .

columnRoleReplaceChanged ( string replace )

此信号发射，当 columnRoleReplace changes to replace .

注意： 相应处理程序是 onColumnRoleReplaceChanged .

itemModelChanged ( model itemModel )

此信号发射，当 itemModel changes to itemModel .

注意： 相应处理程序是 onItemModelChanged .

multiMatchBehaviorChanged ( enumeration behavior )

此信号发射，当 multiMatchBehavior changes to behavior .

注意： 相应处理程序是 onMultiMatchBehaviorChanged .

rowCategoriesChanged ()

此信号发射，当 rowCategories 改变。

注意： 相应处理程序是 onRowCategoriesChanged .

rowRoleChanged ( string role )

此信号发射，当 rowRole changes to role .

注意： 相应处理程序是 onRowRoleChanged .

rowRolePatternChanged ( regExp pattern )

此信号发射，当 rowRolePattern changes to pattern .

注意： 相应处理程序是 onRowRolePatternChanged .

rowRoleReplaceChanged ( string replace )

此信号发射，当 rowRoleReplace changes to replace .

注意： 相应处理程序是 onRowRoleReplaceChanged .

useModelCategoriesChanged ( bool enable )

此信号发射，当 useModelCategories changes to enable .

注意： 相应处理程序是 onUseModelCategoriesChanged .

xPosRoleChanged ( string role )

此信号发射，当 xPosRole changes to role .

注意： 相应处理程序是 onXPosRoleChanged .

xPosRolePatternChanged ( regExp pattern )

此信号发射，当 xPosRolePattern changes to pattern .

注意： 相应处理程序是 onXPosRolePatternChanged .

xPosRoleReplaceChanged ( string replace )

此信号发射，当 xPosRoleReplace changes to replace .

注意： 相应处理程序是 onXPosRoleReplaceChanged .

yPosRoleChanged ( string role )

此信号发射，当 yPosRole changes to role .

注意： 相应处理程序是 onYPosRoleChanged .

yPosRolePatternChanged ( regExp pattern )

此信号发射，当 yPosRolePattern changes to pattern .

注意： 相应处理程序是 onYPosRolePatternChanged .

yPosRoleReplaceChanged ( string replace )

此信号发射，当 yPosRoleReplace changes to replace .

注意： 相应处理程序是 onYPosRoleReplaceChanged .

zPosRoleChanged ( string role )

此信号发射，当 zPosRole changes to role .

注意： 相应处理程序是 onZPosRoleChanged .

zPosRolePatternChanged ( regExp pattern )

此信号发射，当 zPosRolePattern changes to pattern .

注意： 相应处理程序是 onZPosRolePatternChanged .

zPosRoleReplaceChanged ( string replace )

此信号发射，当 zPosRoleReplace changes to replace .

注意： 相应处理程序是 onZPosRoleReplaceChanged .