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

Примечание: Если 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.