Класс QBarDataProxy

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

Этот класс был добавлен в QtDataVisualization 1.0.

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

Свойства

• 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, соответствующие метки строк также удаляются. В противном случае метки строк не затрагиваются.

Примечание: Если removeLabels равно false, массив меток строк будет несинхронизирован с массивом строк, если существуют помеченные строки за пределами удалённых строк.

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.