Класс QBarDataProxy

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

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

Свойства

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

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

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

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

Сигналы

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

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

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

• 1 открытый слот унаследован от QObject
• 11 статических открытых членов унаследовано от QObject
• 9 защищенных функций унаследовано от QObject

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

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

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

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

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

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

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

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

QBarDataProxy::QBarDataProxy(QObject *parent = Q_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.