QSurfaceDataProxy Class

成员函数文档

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

使用给定的parent 实例化QSurfaceDataProxy。

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

删除曲面数据代理。

qsizetype QSurfaceDataProxy::addRow(QSurfaceDataRow row)

将新行row 添加到数组的末尾。新行必须与初始数组中的行具有相同的列数。

返回所添加行所在的索引。

qsizetype QSurfaceDataProxy::addRows(QSurfaceDataArray rows)

将新的rows 添加到数组的末尾。新行必须与初始数组中的行具有相同的列数。

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

[signal] void QSurfaceDataProxy::arrayReset()

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

void QSurfaceDataProxy::insertRow(qsizetype rowIndex, QSurfaceDataRow row)

将新行row 插入到rowIndex 中。如果rowIndex 等于数组大小，则新行将追加到数组末尾。新行的列数必须与初始数组中各行的列数相同。

void QSurfaceDataProxy::insertRows(qsizetype rowIndex, QSurfaceDataArray rows)

将新的rows 插入到rowIndex 中。如果rowIndex 等于数组大小，则行将被添加到数组的末尾。新的rows 必须与初始数组中的行数具有相同的列数。

const QSurfaceDataItem &QSurfaceDataProxy::itemAt(QPoint position) const

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

const QSurfaceDataItem &QSurfaceDataProxy::itemAt(qsizetype rowIndex, qsizetype columnIndex) const

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

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

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

void QSurfaceDataProxy::removeRows(qsizetype rowIndex, qsizetype removeCount)

删除从位置rowIndex 开始、行数为removeCount 的行。如果尝试删除超出数组末尾的行，则不执行任何操作。

void QSurfaceDataProxy::resetArray()

清空现有数组，并触发arrayReset()信号。

void QSurfaceDataProxy::resetArray(QSurfaceDataArray newArray)

* 设置来自newArray 的数组。如果新数组与* 现有数组相等，则该函数仅触发arrayReset()信号。

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

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

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

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

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

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

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

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

当从数组末尾移除由 `count ` 指定的行数时（从位置 `startIndex` 开始），将发出此信号。

如果从数组末尾删除行，则该索引即为当前数组大小。如果未调用removeRows() 便从数组中删除行，则必须发出此信号以更新图形。

void QSurfaceDataProxy::setItem(QPoint position, QSurfaceDataItem item)

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

void QSurfaceDataProxy::setItem(qsizetype rowIndex, qsizetype columnIndex, QSurfaceDataItem item)

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

void QSurfaceDataProxy::setRow(qsizetype rowIndex, QSurfaceDataRow row)

通过将位置为rowIndex 的行替换为由row 指定的新行，来修改现有行。新行可以与已存储在rowIndex 中的现有行相同。新行的列数必须与被替换的行相同。

void QSurfaceDataProxy::setRows(qsizetype rowIndex, QSurfaceDataArray rows)

通过将起始于位置rowIndex 的行替换为由rows 指定的新行，来修改现有行。rows 数组中的行可以与已存储在rowIndex 中的现有行相同。新行的列数必须与被替换行的列数相同。