Класс QBarDataProxy

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

Этот класс был введен в 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.