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)

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

返回新增行的索引。

int QBarDataProxy::addRows(const QBarDataArray &rows)

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

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

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

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

返回第一行的索引。

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)

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

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

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

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

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

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

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

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

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

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

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