QBarDataProxy Class

成员函数文档

[explicit] QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)

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

[override virtual noexcept] QBarDataProxy::~QBarDataProxy()

删除条形图数据代理。

qsizetype QBarDataProxy::addRow(QBarDataRow row)

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

返回所添加行对应的索引。

qsizetype QBarDataProxy::addRow(QBarDataRow row, QString label)

将新行row （标签为label ）添加到数组的末尾。

返回所添加行索引。

qsizetype QBarDataProxy::addRows(QBarDataArray rows)

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

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

qsizetype QBarDataProxy::addRows(QBarDataArray rows, QStringList labels)

将新的rows （其labels ）添加到数组的末尾。

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

[signal] void QBarDataProxy::arrayReset()

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

void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row)

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

void QBarDataProxy::insertRow(qsizetype rowIndex, QBarDataRow row, QString label)

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

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows)

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

void QBarDataProxy::insertRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

将包含labels 的新rows 插入到rowIndex 中。如果rowIndex 等于数组大小，则将这些行追加到数组末尾。

const QBarDataItem &QBarDataProxy::itemAt(QPoint position) const

返回位于位置 `position` 处的项的引用。position 的 x 值表示行，y 值表示列。该项的有效性仅保证到下一次修改数据的调用为止。

const QBarDataItem &QBarDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const

返回指向位于rowIndex 和columnIndex 所指定位置的项的引用。该引用仅在下次修改数据的调用发生之前保证有效。

[signal] void QBarDataProxy::itemChanged(qsizetype rowIndex, qsizetype columnIndex)

当位于rowIndex 和columnIndex 指定位置的项目发生变化时，将触发此信号。如果在数组中修改了该项目而未调用setItem()，则需要触发此信号以更新图形。

void QBarDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount, QBarDataProxy::RemoveLabels removeLabels = RemoveLabels::No)

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

void QBarDataProxy::resetArray()

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

void QBarDataProxy::resetArray(QBarDataArray newArray)

接管数组newArray 。如果新数组与原数组不同，则清空原数组。如果两个数组相同，则该函数仅触发arrayReset()信号。

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

void QBarDataProxy::resetArray(QBarDataArray newArray, QStringList rowLabels, QStringList columnLabels)

接管数组newArray 的所有权。如果新数组与原数组不同，则清空原数组。如果两个数组相同，则该函数仅触发arrayReset()信号。

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

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

const QBarDataRow &QBarDataProxy::rowAt(qsizetype rowIndex) const

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

[signal] void QBarDataProxy::rowsAdded(qsizetype startIndex, qsizetype count)

当从位置startIndex 开始，向数组中添加由 `count ` 指定的行数时，将触发此信号。如果未调用 `addRow()` 或 `addRows()` 便向数组中添加行，则需要触发此信号以更新图形。

[signal] void QBarDataProxy::rowsChanged(qsizetype startIndex, qsizetype count)

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

[signal] void QBarDataProxy::rowsInserted(qsizetype startIndex, qsizetype count)

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

如果未调用insertRow() 或insertRows() 便将行插入数组，则需要发出此信号以更新图形。

[signal] void QBarDataProxy::rowsRemoved(qsizetype startIndex, qsizetype count)

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

如果从数组末尾移除了行，则该索引即为当前数组大小。如果在未调用 `removeRows()` 的情况下从数组中移除了行，则需要发出此信号以更新图形。

void QBarDataProxy::setItem(QPoint position, QBarDataItem item)

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

void QBarDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QBarDataItem item)

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

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row)

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

void QBarDataProxy::setRow(qsizetype rowIndex, QBarDataRow row, QString label)

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

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows)

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

void QBarDataProxy::setRows(qsizetype rowIndex, QBarDataArray rows, QStringList labels)

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