PySide6.QtGraphs.QBar3DSeries¶

class QBar3DSeries¶

QBar3DSeries 类表示3D柱状图中的数据系列。更多…

概要¶

属性¶

• columnLabelsᅟ - 数组的可选列标签

• dataArrayᅟ - 系列的数据数组

• dataProxyᅟ - 活跃的数据代理

• meshAngleᅟ - 系列旋转角度（以度为单位）

• rowColorsᅟ - 系列中的行颜色列表

• rowLabelsᅟ - 数组的可选行标签

• selectedBarᅟ - 系列中被选中的柱状图

方法¶

• def __init__()

• def clearArray()

• def clearRow()

• def columnLabels()

• def dataArray()

• def dataProxy()

• def meshAngle()

• def rowColors()

• def rowLabels()

• def selectedBar()

• def setColumnLabels()

• def setDataArray()

• def setDataProxy()

• def setMeshAngle()

• def setRowColors()

• def setRowLabels()

• def setSelectedBar()

信号¶

• def columnLabelsChanged()

• def dataArrayChanged()

• def dataProxyChanged()

• def meshAngleChanged()

• def rowColorsChanged()

• def rowLabelsChanged()

• def selectedBarChanged()

静态函数¶

• def invalidSelectionPosition()

注意

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

详细描述¶

警告

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

此类管理系列特定的视觉元素，以及系列数据（通过数据代理）。

关于代理系列关系，强调几个关键点至关重要。在这种情况下，数据存储在系列中，用户可以通过系列访问数据集。这个系列由代理对象控制或表示。因此，代理可以用来管理数据的各种操作并更新实际数据集。然而，有必要创建一个与此代理关联的系列来编辑数据集。

如果没有为系列显式设置数据代理，系列将创建一个默认代理。设置另一个代理将销毁现有的代理以及添加到系列中的所有数据。

QBar3DSeries 支持以下格式标签用于 setItemLabelFormat() ：

@rowTitle	行轴标题
@colTitle	来自列轴的标题
@valueTitle	值轴标题
@rowIdx	可见行索引。使用图形区域设置进行本地化。
@colIdx	可见列索引。使用图形区域设置进行本地化。
@rowLabel	行轴的标签
@colLabel	列轴的标签
@valueLabel	使用附加到图表的数值轴格式格式化的项目值。有关更多信息，请参阅labelFormat。
@seriesName	系列名称
%	指定格式的项目值。使用与labelFormat相同的规则进行格式化。

例如：

proxy.setItemLabelFormat("@valueTitle for (@rowLabel, @colLabel): %.1f")

另请参阅

使用3D处理Qt图形数据 locale

注意

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

property columnLabelsᅟ: list of strings¶

此属性保存数组的可选列标签。

此数组中的索引与行中的列索引匹配。如果列表比最长的行短，则所有列都不会获得标签。

Access functions:

• columnLabels()

• setColumnLabels()

• 信号 columnLabelsChanged()

property dataArrayᅟ: list of list of QBarDataItem¶

此属性保存系列的数据数组。

保存数据数组的引用。

当数据数组被设置时，会发出dataArrayChanged信号，除非newDataArray与之前的相同。

注意

在对dataArray进行任何操作之前，必须为相关代理创建一个系列。

另请参阅

clearRow(qsizetype rowIndex) clearArray()

Access functions:

• dataArray()

• setDataArray()

• 信号 dataArrayChanged()

property dataProxyᅟ: QBarDataProxy¶

此属性保存活动数据代理。

该系列假定拥有任何设置给它的代理，并在添加新代理时删除任何先前设置的代理。代理不能为空或设置为另一个系列。

Access functions:

• dataProxy()

• setDataProxy()

• 信号 dataProxyChanged()

property meshAngleᅟ: float¶

此属性保存系列旋转角度（以度为单位）。

设置此属性等同于以下调用：

setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))

注意

当读取此属性时，它是从meshRotation值使用浮点精度计算得出的，并且始终返回一个从零到360度的值。

另请参阅

meshRotation

Access functions:

• meshAngle()

• setMeshAngle()

• 信号 meshAngleChanged()

property rowColorsᅟ: list of QColor¶

此属性保存系列中的行颜色列表。

此属性可用于以不同颜色为系列的行着色。必须将ColorStyle设置为Uniform才能使用此属性。

另请参阅

Uniform

Access functions:

• rowColors()

• setRowColors()

• 信号 rowColorsChanged()

property rowLabelsᅟ: list of strings¶

此属性保存数组的可选行标签。

此数组中的索引与数据数组中的行索引匹配。如果列表比行数短，则所有行都不会获得标签。

Access functions:

• rowLabels()

• setRowLabels()

• 信号 rowLabelsChanged()

property selectedBarᅟ: QPoint¶

此属性保存系列中被选中的条形图。

Access functions:

• selectedBar()

• setSelectedBar()

• 信号 selectedBarChanged()

__init__([parent=None])¶

Parameters:

父对象 – QObject

使用父级 parent 构建一个3D柱状图系列。

__init__(dataProxy[, parent=None])

Parameters:

• dataProxy – QBarDataProxy

• parent – QObject

使用数据代理 dataProxy 和父级 parent 构建一个3D柱状图系列。

clearArray()¶

清除现有数组。

clearRow(rowIndex)¶

Parameters:

rowIndex – int

根据给定的rowIndex清除数组中的现有行。

columnLabels()¶

Return type:

字符串列表

另请参阅

setColumnLabels()

属性 columnLabelsᅟ 的获取器。

columnLabelsChanged()¶

属性 columnLabelsᅟ 的通知信号。

dataArray()¶

Return type:

.列表的列表 QBarDataItem

属性 dataArrayᅟ 的获取器。

dataArrayChanged(array)¶

Parameters:

array – QBarDataItem 的列表的列表

属性 dataArrayᅟ 的通知信号。

dataProxy()¶

Return type:

QBarDataProxy

另请参阅

setDataProxy()

属性 dataProxyᅟ 的获取器。

dataProxyChanged(proxy)¶

Parameters:

代理 – QBarDataProxy

属性 dataProxyᅟ 的通知信号。

static invalidSelectionPosition()¶

Return type:

QPoint

返回一个无效的选择位置。此位置设置为selectedBar属性，以清除此系列中的选择。

另请参阅

clearSelection()

meshAngle()¶

Return type:

浮点数

另请参阅

setMeshAngle()

属性 meshAngleᅟ 的获取器。

meshAngleChanged(angle)¶

Parameters:

angle – 浮点数

属性 meshAngleᅟ 的通知信号。

rowColors()¶

Return type:

QColor的列表

另请参阅

setRowColors()

属性 rowColorsᅟ 的获取器。

rowColorsChanged(rowcolors)¶

Parameters:

rowcolors – QColor 的列表

属性 rowColorsᅟ 的通知信号。

rowLabels()¶

Return type:

字符串列表

另请参阅

setRowLabels()

属性 rowLabelsᅟ 的获取器。

rowLabelsChanged()¶

属性 rowLabelsᅟ 的通知信号。

selectedBar()¶

Return type:

QPoint

另请参阅

setSelectedBar()

属性 selectedBarᅟ 的获取器。

selectedBarChanged(position)¶

Parameters:

位置 – QPoint

属性 selectedBarᅟ 的通知信号。

setColumnLabels(labels)¶

Parameters:

labels – 字符串列表

另请参阅

columnLabels()

属性 columnLabelsᅟ 的设置器。

setDataArray(newDataArray)¶

Parameters:

newDataArray – QBarDataItem 的列表的列表

另请参阅

dataArray()

属性 dataArrayᅟ 的设置器。

setDataProxy(proxy)¶

Parameters:

代理 – QBarDataProxy

另请参阅

dataProxy()

属性 dataProxyᅟ 的设置器。

setMeshAngle(angle)¶

Parameters:

angle – 浮点数

另请参阅

meshAngle()

属性 meshAngleᅟ 的设置器。

setRowColors(colors)¶

Parameters:

颜色 – .QColor 列表

另请参阅

rowColors()

属性 rowColorsᅟ 的设置器。

setRowLabels(labels)¶

Parameters:

labels – 字符串列表

另请参阅

rowLabels()

属性 rowLabelsᅟ 的设置器。

setSelectedBar(position)¶

Parameters:

位置 – QPoint

选择位于数据数组中指定行和列的position位置的条形图。

一次只能选择一个条形图。

要清除此系列中的选择，invalidSelectionPosition() 被设置为 position。

如果将此系列添加到图表中，图表可以根据用户交互或如果变得无效来调整选择。选择另一个添加系列上的条形图也将清除选择。

在所选条形图的行之前删除或插入行将调整选择，以便保持选择相同的条形图。

另请参阅

selectedBar() clearSelection()

属性 selectedBarᅟ 的设置器。