Класс QBarDataProxy

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

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

Свойства

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

• 1 свойство унаследовано от QAbstractDataProxy
• 1 свойство унаследовано от QObject

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

• 1 открытая функция унаследована от QAbstractDataProxy
• 34 открытые функции унаследованы от QObject

Сигналы

• 2 сигнала унаследованы от QObject

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

Дополнительные унаследованные члены

• 1 открытый слот унаследован от QObject
• 1 открытая переменная унаследована от QObject
• 10 статических открытых членов унаследовано от QObject
• 9 защищённых функций унаследовано от QObject
• 2 защищённые переменные унаследованы от QObject

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

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

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

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

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

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

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

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

QBarDataProxy::QBarDataProxy(QObject *parent = nullptr)

Создаёт прокси данных столбцов с заданным parent.

[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

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

[signal] void QBarDataProxy::arrayReset()

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

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 — столбец. Элемент гарантированно действителен только до следующего вызова, изменяющего данные.

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

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

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

[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(), этот сигнал необходимо излучать для обновления графика.

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.