PySide6.QtGraphs.QBarDataProxy

class QBarDataProxy

QBarDataProxy 类是3D条形图的数据代理。更多…

PySide6.QtGraphs.QBarDataProxy 的继承图

继承自： QItemModelBarDataProxy

概要

属性

方法

信号

注意

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

详细描述

一个条形数据代理处理数据的添加、插入、更改和删除行。

数据数组是一个由QBarDataItem实例组成的向量（行）列表。每行可以包含不同数量的项目，甚至可以为空。

QBarDataProxy 拥有所有传递给它的 QtGraphs::QBarDataRow 对象的所有权，无论是直接传递还是通过 QtGraphs::QBarDataArray 容器传递。如果在将数组添加到代理后使用条形数据行指针直接修改数据，则必须发出适当的信号以更新图表。

QBarDataProxy 可以选择性地跟踪行和列标签，QCategory3DAxis 可以利用这些标签来显示轴标签。

行和列的标签存储在系列中的数据之外的单独数组中。代理中提供了行处理方法，并提供了不影响行标签的替代版本。这使得可以选择具有与数据在数组中的位置相关的行标签，而不是数据本身。由于系列包含数据和行和列标签，因此在使用这些函数之前，必须创建一个与代理相关的系列。

另请参阅

使用3D处理Qt图形数据

class RemoveLabels

在版本6.8中添加。

注意

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

property colCountᅟ: int

此属性保存数组中的列数。

Access functions:
property rowCountᅟ: int

此属性保存数组中的行数。

Access functions:
property seriesᅟ: QBar3DSeries

此属性保存此代理附加到的系列。

Access functions:
__init__([parent=None])
Parameters:

父对象 – QObject

使用给定的parent构造一个条形数据代理。

addRow(row)
Parameters:

row – QBarDataItem 的列表

Return type:

整数

将新行 row 添加到数组的末尾。现有的行标签不受影响。

返回添加行的索引。

addRow(row, label)
Parameters:

  • row – QBarDataItem 的列表

  • label – str

Return type:

整数

将带有标签 label 的新行 row 添加到数组的末尾。

返回添加行的索引。

addRows(rows)
Parameters:

rows – .list of list of QBarDataItem

Return type:

整数

将新的rows添加到数组的末尾。现有的行标签不受影响。

返回第一个添加行的索引。

addRows(rows, labels)
Parameters:

  • rows – QBarDataItem 的列表的列表

  • labels – 字符串列表

Return type:

整数

将带有labels的新rows添加到数组的末尾。

返回第一个添加行的索引。

arrayReset()

当数据数组被重置时，会发出此信号。如果整个数组的内容在没有调用resetArray()的情况下被更改，则需要发出此信号以更新图表。

colCount()
Return type:

整数

属性 colCountᅟ 的获取器。

colCountChanged(count)
Parameters:

count – int

属性 colCountᅟ 的通知信号。

insertRow(rowIndex, row)
Parameters:

  • rowIndex – int

  • row – QBarDataItem 的列表

将新行 row 插入到 rowIndex 中。如果 rowIndex 等于数组大小，则行将添加到数组的末尾。现有的行标签不受影响。

注意

如果插入的行之后有标记的行，则在此调用后，行标签数组将与行数组不同步。

insertRow(rowIndex, row, label)
Parameters:

  • rowIndex – int

  • row – QBarDataItem 的列表

  • label – str

将带有标签 label 的新行 row 插入到 rowIndex 中。如果 rowIndex 等于数组大小，则行将添加到数组的末尾。

insertRows(rowIndex, rows)
Parameters:

  • rowIndex – int

  • rows – QBarDataItem 的列表的列表

将新的rows插入到rowIndex中。如果rowIndex等于数组大小，则行将添加到数组的末尾。现有的行标签不受影响。

注意

如果插入的行之后有标记的行，则在此调用后，行标签数组将与行数组不同步。

insertRows(rowIndex, rows, labels)
Parameters:

  • rowIndex – int

  • rows – QBarDataItem 的列表的列表

  • labels – 字符串列表

将带有labels的新rows插入到rowIndex中。如果rowIndex等于数组大小，则行将添加到数组的末尾。

itemAt(position)
Parameters:

位置 – QPoint

Return type:

QBarDataItem

返回对位置position处项目的引用。position的x值表示行，y值表示列。该项目仅在下次修改数据的调用之前保证有效。

itemAt(rowIndex, columnIndex)
Parameters:

  • rowIndex – int

  • columnIndex – int

Return type:

QBarDataItem

返回由rowIndex和columnIndex指定的位置处的项目的引用。保证仅在下次修改数据的调用之前有效。

itemChanged(rowIndex, columnIndex)
Parameters:

  • rowIndex – int

  • columnIndex – int

当位于rowIndex和columnIndex指定的位置的项目发生变化时，会发出此信号。如果项目在数组中被更改而没有调用setItem()，则需要发出此信号以更新图表。

removeRows(rowIndex, removeCount[, removeLabels=QBarDataProxy.RemoveLabels.No])
Parameters:

  • rowIndex – int

  • removeCount – int

  • removeLabels – RemoveLabels

从位置 rowIndex 开始，移除由 removeCount 指定的行数。尝试移除超出数组末尾的行不会产生任何效果。如果 removeLabels 为 true，则相应的行标签也会被移除。否则，行标签不会受到影响。

注意

如果 removeLabels 是 false，则在移除行之后，行标签数组将与行数组不同步，如果存在超出移除行的带标签行。

resetArray()

清除现有的数组以及行和列标签。

resetArray(newArray)
Parameters:

newArray – QBarDataItem 的列表的列表

获取数组 newArray 的所有权。如果新数组与现有数组不同，则清除现有数组。如果数组相同，此函数仅触发 arrayReset() 信号。

传递一个空数组会删除旧数组并创建一个新的空数组。行和列标签不受影响。

resetArray(newArray, rowLabels, columnLabels)
Parameters:

  • newArray – QBarDataItem 的列表的列表

  • rowLabels – 字符串列表

  • columnLabels – 字符串列表

获取数组 newArray 的所有权。如果新数组与现有数组不同，则清除现有数组。如果数组相同，此函数仅触发 arrayReset() 信号。

传递一个空数组会删除旧数组并创建一个新的空数组。

rowLabels 和 columnLabels 列表指定了行和列的新标签。

rowAt(rowIndex)
Parameters:

rowIndex – int

Return type:

QBarDataItem的列表

返回位于位置rowIndex的行的引用。保证仅在下次修改数据的调用之前有效。

rowCount()
Return type:

整数

属性 rowCountᅟ 的获取器。

rowCountChanged(count)
Parameters:

count – int

属性 rowCountᅟ 的通知信号。

rowsAdded(startIndex, count)
Parameters:

  • startIndex – int

  • count – int

当从位置 startIndex 开始添加由 count 指定的行数时，会发出此信号。如果行被添加到数组中而没有调用 addRow() 或 addRows()，则需要发出此信号以更新图表。

rowsChanged(startIndex, count)
Parameters:

  • startIndex – int

  • count – int

当从位置startIndex开始，由count指定的行数发生变化时，会发出此信号。如果在没有调用setRow()或setRows()的情况下更改了数组中的行，则需要发出此信号以更新图表。

rowsInserted(startIndex, count)
Parameters:

  • startIndex – int

  • count – int

当在位置 startIndex 插入由 count 指定的行数时，会发出此信号。

如果行被插入到数组中没有调用insertRow()或insertRows()，则需要发出此信号以更新图表。

rowsRemoved(startIndex, count)
Parameters:

  • startIndex – int

  • count – int

当从位置 startIndex 开始移除由 count 指定的行数时，会发出此信号。

如果从数组的末尾移除了行，则索引是当前数组的大小。如果从数组中移除了行而没有调用removeRows()，则需要发出此信号以更新图表。

series()
Return type:

QBar3DSeries

属性 seriesᅟ 的获取器。

seriesChanged(series)
Parameters:

series – QBar3DSeries

属性 seriesᅟ 的通知信号。

setItem(position, item)
Parameters:

将位置 position 处的单个项目更改为项目 item。position 的 x 值表示行，y 值表示列。

setItem(rowIndex, columnIndex, item)
Parameters:

  • rowIndex – int

  • columnIndex – int

  • 项目 – QBarDataItem

将位于rowIndex和columnIndex指定的位置的单个项目更改为项目item。

setRow(rowIndex, row)
Parameters:

  • rowIndex – int

  • row – QBarDataItem 的列表

通过用row指定的新行替换rowIndex位置的行来更改现有行。新行可以与已存储在rowIndex位置的现有行相同。现有行标签不受影响。

setRow(rowIndex, row, label)
Parameters:

  • rowIndex – int

  • row – QBarDataItem 的列表

  • label – str

通过用row指定的新行替换rowIndex位置的行来更改现有行。新行可以与已存储在rowIndex位置的现有行相同。将行标签更改为label。

setRows(rowIndex, rows)
Parameters:

  • rowIndex – int

  • rows – QBarDataItem 的列表的列表

通过用rows指定的新行替换从rowIndex位置开始的行来更改现有行。现有的行标签不受影响。rows数组中的行可以与已经存储在rowIndex位置的现有行相同。

setRows(rowIndex, rows, labels)
Parameters:

  • rowIndex – int

  • rows – QBarDataItem 的列表的列表

  • labels – 字符串列表

通过用rows指定的新行替换从rowIndex位置开始的行来更改现有行。行标签更改为labels。rows数组中的行可以与已经存储在rowIndex处的现有行相同。