ItemModelBarDataProxy QML Type

用于在项目模型中通过Bars3D 呈现数据的代理类。更多内容...

此类型已弃用。我们强烈建议在新代码中不要使用它。

• 所有成员列表（包括继承的成员）

属性

• autoColumnCategories : bool
• autoRowCategories : bool
• columnCategories : list<String>
• columnRole : string
• columnRolePattern : regExp
• columnRoleReplace : string
• itemModel : model
• multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior
• rotationRole : string
• rotationRolePattern : regExp
• rotationRoleReplace : string
• rowCategories : list<String>
• rowRole : string
• rowRolePattern : regExp
• rowRoleReplace : string
• useModelCategories : bool
• valueRole : string
• valueRolePattern : regExp
• valueRoleReplace : string

详细说明

此类允许您将继承自 AbstractItemModel 的模型用作Bars3D 的数据源。

每当映射或模型发生变化时，数据都会异步解析。当数据解析完成时，会触发QBarDataProxy::arrayReset() 事件。

有关 ItemModelBarDataProxy 枚举，请参阅QItemModelBarDataProxy::MultiMatchBehavior 。

有关更多详细信息，请参阅QItemModelBarDataProxy 文档。

用法示例：

ItemModelBarDataProxy {
    itemModel: model // E.g. a list model defined elsewhere containing yearly expenses data.
    // Mapping model roles to bar series rows, columns, and values.
    rowRole: "year"
    columnRole: "city"
    valueRole: "expenses"
    rowCategories: ["2010", "2011", "2012", "2013"]
    columnCategories: ["Oulu", "Rauma", "Helsinki", "Tampere"]
}

另请参阅 BarDataProxy 以及Qt Data Visualization 中的“数据处理”部分。

属性文档

autoColumnCategories : bool

当设置为true 时，映射会忽略任何显式设置的列类别，并在每次解析模型中的数据时，用自动生成的列类别覆盖它们。默认值为true 。

autoRowCategories : bool

当设置为true 时，该映射会忽略任何显式设置的行类别，并在每次解析模型数据时，用自动生成的行类别覆盖它们。默认值为true 。

columnCategories : list<String>

映射的列类别。在解析数据时，仅包含列角色值出现在此列表中的项目。列的排序顺序与该列表中的顺序一致。

columnRole : string

用于映射到“列类别”的项目模型角色。

columnRolePattern : regExp

启用此属性后，在将由列角色映射的值用作列类别之前，会对其进行搜索和替换操作。该属性指定用于查找映射值中待替换部分的正则表达式，而columnRoleReplace 属性则包含替换字符串。例如，在从项目模型中的单个时间戳字段中解析行和列类别时，此功能非常有用。

另请参阅 columnRole 和columnRoleReplace 。

columnRoleReplace : string

此属性定义了与columnRolePattern 配合使用的替换内容。默认值为空字符串。有关使用正则表达式进行搜索和替换的工作原理的更多信息，请参阅QString::replace （constQRegularExpression &rx, constQString &after）函数文档。

另请参阅 columnRole 和columnRolePattern 。

itemModel : model

该商品的模型。

multiMatchBehavior : ItemModelBarDataProxy.MultiMatchBehavior

定义了如何处理每行/列组合中的多个匹配项。默认值为ItemModelBarDataProxy.MMBLast 。所选的行为将同时影响条形图的数值和旋转角度。

例如，假设您有一个包含不规则间隔采集的带时间戳数据的项模型，并希望通过条形图可视化每天数据项的总值。可以通过指定行和列类别（使每条条形代表一天），并将 multiMatchBehavior 设置为ItemModelBarDataProxy.MMBCumulative 来实现。

rotationRole : string

用于映射为条形旋转角度的项模型角色。

rotationRolePattern : regExp

启用此属性后，在将旋转角色映射的值用作条形旋转角度之前，会对其进行搜索和替换操作。该属性指定用于查找映射值中待替换部分的正则表达式，而rotationRoleReplace 属性则包含替换字符串。

另请参阅 rotationRole 和rotationRoleReplace 。

rotationRoleReplace : string

此属性定义了与rotationRolePattern 配合使用的替换内容。默认值为空字符串。有关使用正则表达式进行搜索和替换的工作原理的更多信息，请参阅QString::replace （constQRegularExpression &rx, constQString &after）函数文档。

另请参阅 rotationRole 和rotationRolePattern 。

rowCategories : list<String>

映射的行类别。在解析数据时，仅包含行角色值出现在此列表中的项目。行的排序顺序与该列表中的顺序一致。

rowRole : string

用于映射到行类别的商品模型角色。

rowRolePattern : regExp

启用此设置后，在将行角色映射的值用作行类别之前，系统会对其进行搜索和替换操作。该属性指定用于查找映射值中待替换部分的正则表达式，而rowRoleReplace 属性则包含替换字符串。例如，在从项目模型中的单个时间戳字段解析行和列类别时，此功能非常有用。

另请参阅 rowRole 和rowRoleReplace 。

rowRoleReplace : string

此属性定义了与rowRolePattern 配合使用的替换内容。默认值为空字符串。有关使用正则表达式进行搜索和替换的工作原理的更多信息，请参阅QString::replace （constQRegularExpression &rx, constQString &after）函数文档。

另请参阅 rowRole 和rowRolePattern 。

useModelCategories : bool

当设置为true 时，映射将忽略行和列的角色及类别，转而使用模型中的行和列。行和列标题将用作行和列的标签。默认值为false 。

valueRole : string

用于映射到条形图值的项目模型角色。

valueRolePattern : regExp

启用此属性后，在将由“value”角色映射的值用作条形图值之前，会对其进行搜索和替换操作。该属性指定用于查找映射值中待替换部分的正则表达式，而valueRoleReplace 属性则包含替换字符串。

另请参阅 valueRole 和valueRoleReplace 。

valueRoleReplace : string

此属性定义了与valueRolePattern 配合使用的替换内容。默认值为空字符串。有关使用正则表达式进行搜索和替换的更多信息，请参阅QString::replace （constQRegularExpression &rx, constQString &after）函数的文档。

另请参阅 valueRole 和valueRolePattern 。