QSurfaceDataProxy Class

Member Function Documentation

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

Constructs QSurfaceDataProxy with the given parent.

[virtual noexcept] QSurfaceDataProxy::~QSurfaceDataProxy()

Deletes the surface data proxy.

int QSurfaceDataProxy::addRow(QSurfaceDataRow *row)

Adds the new row row to the end of an array. The new row must have the same number of columns as the rows in the initial array.

Returns the index of the added row.

int QSurfaceDataProxy::addRows(const QSurfaceDataArray &rows)

Adds new rows to the end of an array. The new rows must have the same number of columns as the rows in the initial array.

Returns the index of the first added row.

const QSurfaceDataArray *QSurfaceDataProxy::array() const

Returns the pointer to the data array.

[signal] void QSurfaceDataProxy::arrayReset()

This signal is emitted when the data array is reset. If the contents of the whole array are changed without calling resetArray(), this signal needs to be emitted to update the graph.

void QSurfaceDataProxy::insertRow(int rowIndex, QSurfaceDataRow *row)

Inserts the new row row into rowIndex. If rowIndex is equal to the array size, the rows are added to the end of the array. The new row must have the same number of columns as the rows in the initial array.

void QSurfaceDataProxy::insertRows(int rowIndex, const QSurfaceDataArray &rows)

Inserts new rows into rowIndex. If rowIndex is equal to the array size, the rows are added to the end of the array. The new rows must have the same number of columns as the rows in the initial array.

const QSurfaceDataItem *QSurfaceDataProxy::itemAt(int rowIndex, int columnIndex) const

Returns the pointer to the item at the position specified by rowIndex and columnIndex. It is guaranteed to be valid only until the next call that modifies data.

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

Returns the pointer to the item at the position position. The x-value of position indicates the row and the y-value indicates the column. The item is guaranteed to be valid only until the next call that modifies data.

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

This signal is emitted when the item at the position specified by rowIndex and columnIndex changes. If the item is changed in the array without calling setItem(), this signal needs to be emitted to update the graph.

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

Removes the number of rows specified by removeCount starting at the position rowIndex. Attempting to remove rows past the end of the array does nothing.

void QSurfaceDataProxy::resetArray(QSurfaceDataArray *newArray)

Takes ownership of the array newArray. Clears the existing array if the new array differs from it. If the arrays are the same, this function just triggers the arrayReset() signal.

Passing a null array deletes the old array and creates a new empty array. All rows in newArray must be of same length.

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

This signal is emitted when the number of rows specified by count is added starting at the position startIndex. If rows are added to the array without calling addRow() or addRows(), this signal needs to be emitted to update the graph.

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

This signal is emitted when the number of rows specified by count is changed starting at the position startIndex. If rows are changed in the array without calling setRow() or setRows(), this signal needs to be emitted to update the graph.

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

This signal is emitted when the number of rows specified by count is inserted at the position startIndex.

If rows are inserted into the array without calling insertRow() or insertRows(), this signal needs to be emitted to update the graph.

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

This signal is emitted when the number of rows specified by count is removed starting at the position startIndex.

The index is the current array size if the rows were removed from the end of the array. If rows are removed from the array without calling removeRows(), this signal needs to be emitted to update the graph.

void QSurfaceDataProxy::setItem(int rowIndex, int columnIndex, const QSurfaceDataItem &item)

Changes a single item at the position specified by rowIndex and columnIndex to the item item.

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

Changes a single item at the position position to the item item. The x-value of position indicates the row and the y-value indicates the column.

void QSurfaceDataProxy::setRow(int rowIndex, QSurfaceDataRow *row)

Changes an existing row by replacing the row at the position rowIndex with the new row specified by row. The new row can be the same as the existing row already stored at the rowIndex. The new row must have the same number of columns as the row it is replacing.

void QSurfaceDataProxy::setRows(int rowIndex, const QSurfaceDataArray &rows)

Changes existing rows by replacing the rows starting at the position rowIndex with the new rows specifies by rows. The rows in the rows array can be the same as the existing rows already stored at the rowIndex. The new rows must have the same number of columns as the rows they are replacing.