Класс QBar3DSeries
Класс QBar3DSeries представляет серию данных в 3D столбчатой диаграмме. Подробнее...
| Заголовок: | #include <QBar3DSeries> |
| С момента: | QtDataVisualization 1.0 |
| Инициализируется: | Bar3DSeries |
| Наследуется от: | QAbstract3DSeries |
Свойства
- dataProxy : QBarDataProxy*
- meshAngle : float
- selectedBar : QPoint
Открытые функции
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| QBar3DSeries(QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setSelectedBar(const QPoint &position) |
Сигналы
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | selectedBarChanged(const QPoint &position) |
Статические открытые члены
| QPoint | invalidSelectionPosition() |
Подробное описание
Этот класс управляет визуальными элементами, специфичными для серии, а также данными серии (через прокси данных).
Если для серии явно не задан прокси данных, серия создаёт прокси по умолчанию. Установка другого прокси уничтожит существующий прокси и все данные, добавленные в него.
QBar3DSeries поддерживает следующие теги формата для QAbstract3DSeries::setItemLabelFormat():
| @rowTitle | Название с оси строк |
| @colTitle | Название с оси столбцов |
| @valueTitle | Название с оси значений |
| @rowIdx | Видимый индекс строки. Локализуется с использованием локали графика. |
| @colIdx | Видимый индекс столбца. Локализуется с использованием локали графика. |
| @rowLabel | Метка с оси строк |
| @colLabel | Метка с оси столбцов |
| @valueLabel | Значение элемента, отформатированное с использованием формата оси значений, присоединённой к графику. Дополнительную информацию см. в QValue3DAxis::labelFormat. |
| @seriesName | Имя серии |
| %<спецификация формата> | Значение элемента в заданном формате. Форматируется по тем же правилам, что и QValue3DAxis::labelFormat. |
Например:
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f")); См. также Обработка данных Qt Data Visualization и QAbstract3DGraph::locale.
Документация по свойствам
dataProxy : QBarDataProxy*
Это свойство содержит активный прокси данных.
Серия принимает во владение любой прокси, установленный для неё, и удаляет ранее установленный прокси при добавлении нового. Прокси не может быть нулевым или установленным для другой серии.
Функции доступа:
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
Сигнал уведомления:
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
Это свойство содержит угол вращения серии в градусах.
Установка этого свойства эквивалентна следующему вызову:
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
Примечание: При чтении этого свойства оно вычисляется из значения QAbstract3DSeries::meshRotation с использованием точности чисел с плавающей запятой и всегда возвращает значение от нуля до 360 градусов.
Функции доступа:
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
Сигнал уведомления:
| void | meshAngleChanged(float angle) |
См. также QAbstract3DSeries::meshRotation.
selectedBar : QPoint
Это свойство содержит столбец в серии, который выбран.
Функции доступа:
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
Сигнал уведомления:
| void | selectedBarChanged(const QPoint &position) |
Документация по функциям-членам
QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
Конструирует серию столбчатых 3D графиков с прокси данных dataProxy и родителем parent.
QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
Конструирует серию столбчатых 3D графиков с родителем parent.
[virtual] QBar3DSeries::~QBar3DSeries()
Удаляет серию столбчатых 3D графиков.
[static] QPoint QBar3DSeries::invalidSelectionPosition()
Возвращает недопустимую позицию для выбора. Эта позиция устанавливается в свойство selectedBar для очистки выбора из этой серии.
См. также QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const QPoint &position)
Выбирает столбец в позиции position, указанной как строка и столбец в массиве данных серии.
Одновременно может быть выбран только один столбец.
Для очистки выбора из этой серии устанавливается invalidSelectionPosition() как position.
Если эта серия добавлена в график, график может скорректировать выбор в соответствии с взаимодействием пользователя или если он становится недействительным. Выбор столбца в другой добавленной серии также очистит выбор.
Удаление строк или вставка строк в серию перед строкой выбранного столбца скорректирует выбор, так что выбранный столбец останется выбранным.
Примечание: Функция-сеттер для свойства selectedBar.
См. также selectedBar() и QAbstract3DGraph::clearSelection().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.2/qbar3dseries.html
