Класс QBarDataProxy

Класс QBarDataProxy является прокси-объектом данных для графика 3D столбцов. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• columnLabels : QStringList
• rowCount : const int
• rowLabels : QStringList
• series : QBar3DSeries* const

Открытые функции

Сигналы

Связанные нечлены

Подробное описание

Прокси данных диаграммы в виде столбцов обрабатывает добавление, вставку, изменение и удаление строк данных.

Массив данных представляет собой список векторов (строк) экземпляров QBarDataItem. Каждая строка может содержать разное количество элементов или быть пустой.

QBarDataProxy принимает во владение все объекты QtDataVisualization::QBarDataRow, переданные ему, независимо от того, передаются ли они напрямую или в контейнере QtDataVisualization::QBarDataArray. Если указатели на строки данных столбцов используются для непосредственного изменения данных после добавления массива в прокси, необходимо выпустить соответствующий сигнал для обновления графика.

QBarDataProxy необязательно отслеживает метки строк и столбцов, которые QCategory3DAxis может использовать для отображения меток осей. Метки строк и столбцов хранятся в отдельном массиве, а методы манипулирования строками предоставляют альтернативные версии, которые не влияют на метки строк. Это позволяет иметь метки строк, связанные с позицией данных в массиве, а не с самими данными.

См. также Обработка данных в Qt Data Visualization.

Документация по членам функций

QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)

Создает прокси данных столбчатой диаграммы с заданным parent.

[signal] void QBarDataProxy::arrayReset()

Этот сигнал излучается при сбросе массива данных. Если содержимое всего массива изменено без вызова resetArray(), этот сигнал необходимо издать для обновления графика.

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

Этот сигнал излучается, когда элемент в позиции, указанной rowIndex и columnIndex, изменяется. Если элемент изменяется в массиве без вызова setItem(), этот сигнал необходимо издать для обновления графика.

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

Этот сигнал излучается, когда добавляется указанное количество строк count, начиная с позиции startIndex. Если строки добавляются в массив без вызова 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)

Этот сигнал излучается, когда количество строк, указанное count, удаляется, начиная с позиции startIndex.

Индекс — текущий размер массива, если строки были удалены с конца массива. Если строки удаляются из массива без вызова removeRows(), этот сигнал необходимо издать для обновления графика.

[virtual] 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

Возвращает указатель на массив данных.

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

Вставляет новую строку row в rowIndex. Если rowIndex равно размеру массива, строки добавляются в конец массива. Существующие метки строк не затрагиваются.

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

Вставляет новую строку row с меткой label в 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(int rowIndex, int columnIndex) const

Возвращает указатель на элемент в позиции, указанной rowIndex и columnIndex. Гарантируется, что он остается действительным только до следующего вызова, изменяющего данные.

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

Возвращает указатель на элемент в позиции position. Значение x в position указывает строку, а значение y — столбец. Гарантируется, что элемент будет валиден до следующего вызова, изменяющего данные.

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

Удаляет количество строк, указанное в removeCount, начиная с позиции rowIndex. Попытка удалить строки за пределами массива ничего не делает. Если 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. Гарантируется, что он будет валиден до следующего вызова, изменяющего данные.

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

Изменяет единственный элемент в позиции, заданной rowIndex и columnIndex, на элемент item.

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

Изменяет единственный элемент в позиции position на элемент item. Значение x в position указывает строку, а значение y — столбец.

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.