Класс QBar3DSeries
Класс QBar3DSeries представляет собой серию данных в 3D столбчатой диаграмме. Подробнее...
| Заголовок: | #include <QBar3DSeries> |
| С момента: | QtDataVisualization 1.0 |
| Создается с помощью: | Bar3DSeries |
| Наследуется от: | QAbstract3DSeries |
Этот класс был представлен в QtDataVisualization 1.0.
Свойства
- 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*
Это свойство содержит активный прокси-сервер данных.
Серия принимает во владение любой прокси-сервер, установленный для неё, и удаляет любой ранее установленный прокси-сервер при добавлении нового. Прокси-сервер не может быть null или установлен для другой серии.
Функции доступа:
| 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-5.15/qbar3dseries.html
