PySide6.QtGraphs.QItemModelBarDataProxy¶

class QItemModelBarDataProxy¶

用于在项目模型中展示数据的代理类，使用Q3DBarsWidgetItem。更多…

概要¶

属性¶

autoColumnCategoriesᅟ - 是否自动生成列类别
autoRowCategoriesᅟ - 是否自动生成行类别
columnCategoriesᅟ - 映射的列类别
columnRoleᅟ - 映射的列角色
columnRolePatternᅟ - 在使用列角色映射的值作为列类别之前，是否对其进行了搜索和替换
columnRoleReplaceᅟ - 与columnRolePattern一起使用的替换内容
itemModelᅟ - 项目模型
multiMatchBehaviorᅟ - 如何处理每行/列组合的多个匹配项
rotationRoleᅟ - 映射的旋转角色
rotationRolePatternᅟ - 在使用映射的旋转角色值作为条形图旋转角度之前，是否对其进行了搜索和替换
rotationRoleReplaceᅟ - 与rotationRolePattern一起使用的替换内容
rowCategoriesᅟ - 映射的行类别
rowRoleᅟ - 映射的行角色
rowRolePatternᅟ - 在使用行角色映射的值作为行类别之前，是否对其执行搜索和替换操作
rowRoleReplaceᅟ - 与rowRolePattern一起使用的替换内容
useModelCategoriesᅟ - 是否使用行和列的角色和类别进行映射
valueRoleᅟ - 映射的值角色
valueRolePatternᅟ - 在使用映射值作为条形图值之前，是否对由值角色映射的值进行搜索和替换
valueRoleReplaceᅟ - 与valueRolePattern一起使用的替换内容

方法¶

def __init__()
def autoColumnCategories()
def autoRowCategories()
def columnCategories()
def columnCategoryIndex()
def columnRole()
def columnRolePattern()
def columnRoleReplace()
def itemModel()
def multiMatchBehavior()
def remap()
def rotationRole()
def rotationRolePattern()
def rotationRoleReplace()
def rowCategories()
def rowCategoryIndex()
def rowRole()
def rowRolePattern()
def rowRoleReplace()
def setAutoColumnCategories()
def setAutoRowCategories()
def setColumnCategories()
def setColumnRole()
def setColumnRolePattern()
def setColumnRoleReplace()
def setItemModel()
def setMultiMatchBehavior()
def setRotationRole()
def setRotationRolePattern()
def setRotationRoleReplace()
def setRowCategories()
def setRowRole()
def setRowRolePattern()
def setRowRoleReplace()
def setUseModelCategories()
def setValueRole()
def setValueRolePattern()
def setValueRoleReplace()
def useModelCategories()
def valueRole()
def valueRolePattern()
def valueRoleReplace()

信号¶

def autoColumnCategoriesChanged()
def autoRowCategoriesChanged()
def columnCategoriesChanged()
def columnRoleChanged()
def columnRolePatternChanged()
def columnRoleReplaceChanged()
def itemModelChanged()
def multiMatchBehaviorChanged()
def rotationRoleChanged()
def rotationRolePatternChanged()
def rotationRoleReplaceChanged()
def rowCategoriesChanged()
def rowRoleChanged()
def rowRolePatternChanged()
def rowRoleReplaceChanged()
def useModelCategoriesChanged()
def valueRoleChanged()
def valueRolePatternChanged()
def valueRoleReplaceChanged()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

QItemModelBarDataProxy 允许你使用 QAbstractItemModel 派生模型作为 Q3DBarsWidgetItem 的数据源。它使用定义的映射将模型中的数据映射到 Q3DBarsWidgetItem 图表的行、列和值。

每当映射或模型发生变化时，数据都会异步解析。当数据解析完成时，会发出arrayReset()。然而，当useModelCategories属性设置为true时，单个项目的更改会同步解析，除非同一帧中还包含导致整个模型解析的更改。

映射可以用于以下方式：

如果 useModelCategories 属性设置为 true，此代理将直接将 QAbstractItemModel 的行和列映射到 Q3DBarsWidgetItem 的行和列，并默认使用 Qt::DisplayRole 返回的值作为条形值。如果 Qt::DisplayRole 不合适，可以重新定义要使用的值角色。

对于没有数据已经整齐地排序成行和列的模型，例如基于QAbstractListModel的模型，您可以从模型中定义一个角色来映射每一行、列和值。

如果您不想包含模型中包含的所有数据，或者自动生成的行和列没有按照您的意愿排序，您可以通过为行和列中的任意一个或两者定义明确的类别列表来指定应包含哪些行和列以及它们的顺序。

例如，假设您有一个自定义的QAbstractItemModel用于存储与业务相关的各种月度值。模型中的每个项目都有“year”、“month”、“income”和“expenses”这些角色。您可以执行以下操作以在条形图中显示数据：

# By defining row and column categories, you tell the mapping which row and column each item
# belongs to. The categories must match the data stored in the model in the roles you define
# for row and column mapping. In this example we expect "year" role to return four digit year
# and "month" to return three letter designation for the month.
#
# An example of an item in model would be:
# Requested role -> Returned data
# "year" -> "2016" // Matches the first row category, so this item is added to the first row.
# "month" -> "jan" // Matches the first column category, so this item is added as first item in the row.
# "income" -> "12.1"
# "expenses" -> "9.2"
years = QStringList()
months = QStringList()
years << "2016" << "2017" << "2018" << "2019" << "2020" << "2021" << "2022"
months << "jan" << "feb" << "mar" << "apr" << "may" << "jun" << "jul" << "aug" << "sep" << "oct" << "nov" << "dec"
proxy = QItemModelBarDataProxy(customModel,()
                                                           "year", // Row role
                                                           "month", // Column role
                                                           "income", // Value role
                                                           years, // Row categories
                                                           months) # Column categories
#...
# To display different data later, you can simply change the mapping.
proxy.setValueRole("expenses")

如果模型的字段不包含您所需的确切格式的数据，您可以为每个角色指定一个搜索模式正则表达式和一个替换规则，以获取所需格式的值。有关如何使用正则表达式进行替换的更多信息，请参阅QString::replace(const QRegularExpression ℞, const QString &after)函数文档。请注意，使用正则表达式会影响性能，因此在不需要进行搜索和替换即可获得所需值的情况下，使用项模型更为高效。

例如，关于将搜索模式与角色结合使用的示例，请参见简单条形图。

另请参阅

使用3D处理Qt图形数据

class MultiMatchBehavior¶

multiMatchBehavior 属性的行为类型。

常量

描述

QItemModelBarDataProxy.MultiMatchBehavior.First

该值取自与每个行/列组合匹配的项目模型中的第一个项目。

QItemModelBarDataProxy.MultiMatchBehavior.Last

该值取自与每个行/列组合匹配的项目模型中的最后一项。

QItemModelBarDataProxy.MultiMatchBehavior.Average

匹配每个行/列组合的所有项目的值将被平均，平均值将用作条形图的值。

QItemModelBarDataProxy.MultiMatchBehavior.Cumulative

匹配每个行/列组合的所有项目的值相加，总和用作条形值。

常量	描述
QItemModelBarDataProxy.MultiMatchBehavior.First	该值取自与每个行/列组合匹配的项目模型中的第一个项目。
QItemModelBarDataProxy.MultiMatchBehavior.Last	该值取自与每个行/列组合匹配的项目模型中的最后一项。
QItemModelBarDataProxy.MultiMatchBehavior.Average	匹配每个行/列组合的所有项目的值将被平均，平均值将用作条形图的值。
QItemModelBarDataProxy.MultiMatchBehavior.Cumulative	匹配每个行/列组合的所有项目的值相加，总和用作条形值。

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property autoColumnCategoriesᅟ: bool¶

此属性保存是否自动生成列类别。

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

Access functions:

autoColumnCategories()
setAutoColumnCategories()
信号 autoColumnCategoriesChanged()

property autoRowCategoriesᅟ: bool¶

此属性保存是否自动生成行类别。

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

Access functions:

autoRowCategories()
setAutoRowCategories()
信号 autoRowCategoriesChanged()

property columnCategoriesᅟ: list of strings¶

此属性保存映射的列类别。

Access functions:

columnCategories()
setColumnCategories()
信号 columnCategoriesChanged()

property columnRoleᅟ: str¶

此属性保存映射的列角色。

Access functions:

columnRole()
setColumnRole()
信号 columnRoleChanged()

property columnRolePatternᅟ: QRegularExpression¶

此属性保存是否在将列角色映射的值用作列类别之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而columnRoleReplace属性包含替换字符串。这在例如从项目模型中的单个时间戳字段解析行和列类别时非常有用。

另请参阅

columnRole columnRoleReplace

Access functions:

columnRolePattern()
setColumnRolePattern()
信号 columnRolePatternChanged()

property columnRoleReplaceᅟ: str¶

此属性保存与columnRolePattern一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

columnRole columnRolePattern

Access functions:

columnRoleReplace()
setColumnRoleReplace()
信号 columnRoleReplaceChanged()

property itemModelᅟ: QAbstractItemModel¶

此属性保存项目模型。

Access functions:

itemModel()
setItemModel()
信号 itemModelChanged()

property multiMatchBehaviorᅟ: QItemModelBarDataProxy.MultiMatchBehavior¶

此属性决定了如何处理每行/列组合的多个匹配项。

默认为 Last。所选行为会影响条形值和旋转。

例如，您可能有一个包含不规则间隔时间戳数据的项目模型，并且您希望使用条形图可视化每天数据项的总价值。这可以通过指定行和列类别来实现，以便每个条形代表一天，并将multiMatchBehavior设置为Cumulative。

Access functions:

multiMatchBehavior()
setMultiMatchBehavior()
信号 multiMatchBehaviorChanged()

property rotationRoleᅟ: str¶

此属性保存映射的旋转角色。

Access functions:

rotationRole()
setRotationRole()
信号 rotationRoleChanged()

property rotationRolePatternᅟ: QRegularExpression¶

此属性保存是否在将旋转角色映射的值用作条形旋转角度之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而rotationRoleReplace属性包含替换字符串。

另请参阅

rotationRole rotationRoleReplace

Access functions:

rotationRolePattern()
setRotationRolePattern()
信号 rotationRolePatternChanged()

property rotationRoleReplaceᅟ: str¶

此属性保存与rotationRolePattern一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

rotationRole rotationRolePattern

Access functions:

rotationRoleReplace()
setRotationRoleReplace()
信号 rotationRoleReplaceChanged()

property rowCategoriesᅟ: list of strings¶

此属性保存映射的行类别。

Access functions:

rowCategories()
setRowCategories()
信号 rowCategoriesChanged()

property rowRoleᅟ: str¶

此属性保存映射的行角色。

Access functions:

rowRole()
setRowRole()
信号 rowRoleChanged()

property rowRolePatternᅟ: QRegularExpression¶

此属性保存是否在将行角色映射的值用作行类别之前对其执行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而rowRoleReplace属性包含替换字符串。这在例如从项目模型中的单个时间戳字段解析行和列类别时非常有用。

另请参阅

rowRole rowRoleReplace

Access functions:

rowRolePattern()
setRowRolePattern()
信号 rowRolePatternChanged()

property rowRoleReplaceᅟ: str¶

此属性保存与rowRolePattern一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

rowRole rowRolePattern

Access functions:

rowRoleReplace()
setRowRoleReplace()
信号 rowRoleReplaceChanged()

property useModelCategoriesᅟ: bool¶

此属性保存是否使用行和列角色及类别进行映射。

当设置为true时，映射将忽略行和列的角色和类别，并使用模型中的行和列。默认为false。

Access functions:

useModelCategories()
setUseModelCategories()
信号 useModelCategoriesChanged()

property valueRoleᅟ: str¶

此属性保存映射的值角色。

Access functions:

valueRole()
setValueRole()
信号 valueRoleChanged()

property valueRolePatternᅟ: QRegularExpression¶

此属性保存是否在将值角色映射的值用作条形值之前对其进行搜索和替换。

此属性指定用于查找要替换的映射值部分的正则表达式，而valueRoleReplace属性包含替换字符串。

另请参阅

valueRole valueRoleReplace

Access functions:

valueRolePattern()
setValueRolePattern()
信号 valueRolePatternChanged()

property valueRoleReplaceᅟ: str¶

此属性保存与valueRolePattern一起使用的替换内容。

默认为空字符串。有关如何使用正则表达式进行搜索和替换的更多信息，请参阅 QString::replace(const QRegularExpression ℞, const QString &after) 函数文档。

另请参阅

valueRole valueRolePattern

Access functions:

valueRoleReplace()
setValueRoleReplace()
信号 valueRoleReplaceChanged()

__init__([parent=None])¶

Parameters:: 父对象 – QObject

使用可选的parent构造QItemModelBarDataProxy。

__init__(itemModel[, parent=None])

Parameters:

itemModel – QAbstractItemModel
parent – QObject

使用 itemModel 和一个可选的 parent 构造 QItemModelBarDataProxy。代理不会获取 itemModel 的所有权，因为通常项目模型由其他控件拥有。

__init__(itemModel, valueRole[, parent=None])

Parameters:

itemModel – QAbstractItemModel
valueRole – str
parent – QObject

使用itemModel和一个可选的parent构造QItemModelBarDataProxy。代理不拥有itemModel的所有权，因为通常项目模型由其他控件拥有。值角色设置为valueRole。此构造函数旨在用于数据已经按行和列正确排序的模型，因此它还将useModelCategories属性设置为true。

__init__(itemModel, rowRole, columnRole, valueRole[, parent=None])

Parameters:

itemModel – QAbstractItemModel
rowRole – str
columnRole – str
valueRole – str
parent – QObject

使用itemModel和一个可选的parent构造QItemModelBarDataProxy。代理不会获取itemModel的所有权，因为通常项目模型由其他控件拥有。角色映射通过rowRole、columnRole和valueRole设置。

__init__(itemModel, rowRole, columnRole, valueRole, rotationRole[, parent=None])

Parameters:

itemModel – QAbstractItemModel
rowRole – str
columnRole – str
valueRole – str
rotationRole – str
parent – QObject

__init__(itemModel, rowRole, columnRole, valueRole, rowCategories, columnCategories[, parent=None])

Parameters:

itemModel – QAbstractItemModel
rowRole – str
columnRole – str
valueRole – str
rowCategories – 字符串列表
columnCategories – 字符串列表
parent – QObject

使用itemModel和一个可选的parent构造QItemModelBarDataProxy。代理不拥有itemModel的所有权，因为通常项目模型由其他控件拥有。角色映射通过rowRole、columnRole和valueRole设置。行和列类别通过rowCategories和columnCategories设置。此构造函数还将autoRowCategories和autoColumnCategories设置为false。

__init__(itemModel, rowRole, columnRole, valueRole, rotationRole, rowCategories, columnCategories[, parent=None])

Parameters:

itemModel – QAbstractItemModel
rowRole – str
columnRole – str
valueRole – str
rotationRole – str
rowCategories – 字符串列表
columnCategories – 字符串列表
parent – QObject

使用itemModel和一个可选的parent构造QItemModelBarDataProxy。代理不会获取itemModel的所有权，因为通常项目模型由其他控件拥有。角色映射通过rowRole、columnRole、valueRole和rotationRole设置。行和列类别通过rowCategories和columnCategories设置。此构造函数还将autoRowCategories和autoColumnCategories设置为false。