Класс 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, заданной как строка и столбец в массиве данных ряда.
Одновременно может быть выделен только один столбец.
Чтобы очистить выделение из этого ряда, в качестве position устанавливается invalidSelectionPosition().
Если этот ряд добавлен в график, график может настроить выделение в соответствии с взаимодействием пользователя или если оно становится недопустимым. Выделение столбца в другом добавленном ряду также очистит выделение.
Удаление строк или вставка строк в ряд перед строкой выделенного столбца скорректирует выделение, так что тот же самый столбец останется выделенным.
Примечание: Функция-сеттер для свойства selectedBar.
См. также selectedBar() и QAbstract3DGraph::clearSelection().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qbar3dseries.html
