Класс 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 | Имя серии |
| %<format spec> | Значение элемента в указанном формате. Форматируется по тем же правилам, что и 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-5.13/qbar3dseries.html
