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)

在数组末尾添加标有label 的新行row 。

返回新增行的索引。

qsizetype QBarDataProxy::addRows(QBarDataArray rows)

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

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

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

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

返回第一行的索引。

[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)

将新的rows 与labels 插入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)

当count 指定的行数被插入startIndex 的位置时，就会发出该信号。

如果在未调用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)

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

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

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

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

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

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

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