QBarDataProxy Class

成员函数文档

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

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

[virtual noexcept] QBarDataProxy::~QBarDataProxy()

删除条形数据代理。

int QBarDataProxy::addRow(QBarDataRow *row)

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

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

int QBarDataProxy::addRow(QBarDataRow *row, const QString &label)

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

返回所添加行索引。

int QBarDataProxy::addRows(const QBarDataArray &rows)

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

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

int QBarDataProxy::addRows(const QBarDataArray &rows, const QStringList &labels)

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

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

const QBarDataArray *QBarDataProxy::array() const

返回指向数据数组的指针。

[signal] void QBarDataProxy::arrayReset()

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

void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row)

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

void QBarDataProxy::insertRow(int rowIndex, QBarDataRow *row, const QString &label)

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

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows)

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

void QBarDataProxy::insertRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

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

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

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

const QBarDataItem *QBarDataProxy::itemAt(int rowIndex, int columnIndex) const

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

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

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

void QBarDataProxy::removeRows(int rowIndex, int removeCount, bool removeLabels = true)

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

void QBarDataProxy::resetArray()

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

void QBarDataProxy::resetArray(QBarDataArray *newArray)

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

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

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

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

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

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

const QBarDataRow *QBarDataProxy::rowAt(int rowIndex) const

返回指向位置为rowIndex 的行的指针。该指针仅在下次修改数据的调用之前保证有效。

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

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

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

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

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

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

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

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

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

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

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

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

void QBarDataProxy::setItem(int rowIndex, int columnIndex, const QBarDataItem &item)

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

void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row)

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

void QBarDataProxy::setRow(int rowIndex, QBarDataRow *row, const QString &label)

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

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows)

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

void QBarDataProxy::setRows(int rowIndex, const QBarDataArray &rows, const QStringList &labels)

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