Класс Q3DBars

Класс Q3DBars предоставляет методы для отрисовки 3D столбчатых диаграмм. Подробнее...

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

Свойства

• 19 свойств унаследовано от QAbstract3DGraph
• 16 свойств унаследовано от QWindow
• 1 свойство унаследовано от QObject

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

• 54 общедоступные функции, унаследованные от QAbstract3DGraph
• 85 общедоступные функции, унаследованные от QWindow
• 145 общедоступные функции, унаследованные от QOpenGLFunctions
• 34 общедоступные функции, унаследованные от QObject
• 6 общедоступные функции, унаследованные от QSurface

Сигналы

• 18 сигналов, унаследованных от QAbstract3DGraph
• 18 сигналов, унаследованных от QWindow
• 2 сигналов, унаследованных от QObject

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

• 24 public slots, унаследованные от QWindow
• 1 public slot, унаследованный от QObject
• 1 public переменная, унаследованная от QWindow
• 1 public переменная, унаследованная от QObject
• 3 статических public членов, унаследованных от QWindow
• 10 статических public членов, унаследованных от QObject
• 18 protected функций, унаследованных от QWindow
• 9 protected функций, унаследованных от QObject
• 1 protected тип, унаследованный от QOpenGLFunctions
• 2 protected переменных, унаследованных от QObject
• 2 protected переменных, унаследованных от QSurface

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

Класс Q3DBars предоставляет методы для визуализации 3D столбчатых диаграмм.

Этот класс позволяет разработчикам визуализировать столбчатые диаграммы в 3D формате и просматривать их, свободно вращая сцену. Вращение выполняется удерживанием правой кнопки мыши и перемещением курсора. Масштабирование выполняется колесиком мыши. Выбор, если включен, выполняется левой кнопкой мыши. Сцена может быть сброшена к исходному виду камеры, нажав колесиком мыши. На сенсорных устройствах вращение выполняется нажатием и перемещением, выбор — нажатием и удерживанием, а масштабирование — с помощью двух касаний.

Если оси не установлены явно для Q3DBars, создаются временные значения по умолчанию с пустыми метками. Эти оси по умолчанию могут быть изменены с помощью методов доступа к осям, но как только любая ось устанавливается явно для ориентации, ось по умолчанию для этой ориентации уничтожается.

Q3DBars поддерживает одновременное отображение более чем одного ряда данных. Не обязательно, чтобы все ряды имели одинаковое количество строк и столбцов. Метки строк и столбцов берутся из первого добавленного ряда, если не определены явно для осей строк и столбцов.

Как создать минимальную диаграмму Q3DBars

Сначала создайте экземпляр Q3DBars. Поскольку в этом примере диаграмма запускается как основное окно, нам необходимо очистить флаг Qt::FramelessWindowHint, который устанавливается по умолчанию:

Q3DBars bars;
bars.setFlags(bars.flags() ^ Qt::FramelessWindowHint);

После создания Q3DBars, вы можете установить область данных, изменив диапазон на осях строк и столбцов. Это не обязательно, так как область данных по умолчанию отображает все данные в рядах. Если количество данных велико, обычно предпочтительно отображать только часть из них. В примере установим область данных для отображения первых пяти строк и столбцов:

bars.rowAxis()->setRange(0, 4);
bars.columnAxis()->setRange(0, 4);

Теперь Q3DBars готов принять данные для визуализации. Создайте ряд с одной строкой из 5 значений:

QBar3DSeries *series = new QBar3DSeries;
QBarDataRow *data = new QBarDataRow;
*data << 1.0f << 3.0f << 7.5f << 5.0f << 2.2f;
series->dataProxy()->addRow(data);
bars.addSeries(series);

Примечание: Мы установили область данных 5x5, но добавляем только одну строку данных. Это нормально, остальные строки будут пустыми.

Наконец, вам необходимо сделать его видимым:

bars.show();

Полный код, необходимый для создания и отображения этой диаграммы:

#include <QtDataVisualization>

using namespace QtDataVisualization;

int main(int argc, char **argv)
{
    QGuiApplication app(argc, argv);

    Q3DBars bars;
    bars.setFlags(bars.flags() ^ Qt::FramelessWindowHint);
    bars.rowAxis()->setRange(0, 4);
    bars.columnAxis()->setRange(0, 4);
    QBar3DSeries *series = new QBar3DSeries;
    QBarDataRow *data = new QBarDataRow;
    *data << 1.0f << 3.0f << 7.5f << 5.0f << 2.2f;
    series->dataProxy()->addRow(data);
    bars.addSeries(series);
    bars.show();

    return app.exec();
}

И вот что генерируют эти несколько строк кода:

Сцену можно вращать, приближать и выбирать столбец для просмотра его значения, но никакие другие взаимодействия не включены в этот минимальный пример кода. Вы можете узнать больше, ознакомившись с примерами, такими как Пример столбчатых диаграмм.

См. также Q3DScatter, Q3DSurface и Классы Qt Data Visualization C++.

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

Q3DBars::Q3DBars(const QSurfaceFormat *format = nullptr, QWindow *parent = nullptr)

Создает новую 3D столбчатую диаграмму с необязательным родительским окном parent и форматом поверхности format.

[virtual] Q3DBars::~Q3DBars()

Уничтожает 3D столбчатую диаграмму.

void Q3DBars::addAxis(QAbstract3DAxis *axis)

Добавляет axis к графику. Оси, добавленные через addAxis, пока не используются, addAxis просто используется для передачи владения axis графику. axis не должен быть null или добавлен к другому графику.

См. также releaseAxis(), setValueAxis(), setRowAxis() и setColumnAxis().

void Q3DBars::addSeries(QBar3DSeries *series)

Добавляет series на график. График может содержать несколько рядов, но только один набор осей, поэтому строки и столбцы всех рядов должны совпадать, чтобы визуализированные данные были осмысленными. Если на графике несколько видимых рядов, только основной ряд будет генерировать метки строк или столбцов на осях в тех случаях, когда метки не заданы явно для осей. Если только что добавленный ряд указал выделенный столбец, он будет выделен, а любое существующее выделение будет очищено. Только один добавленный ряд может иметь активное выделение.

/sa seriesList(), primarySeries

QList<QAbstract3DAxis *> Q3DBars::axes() const

Возвращает список всех добавленных осей.

См. также addAxis().

void Q3DBars::insertSeries(int index, QBar3DSeries *series)

Вставляет series в позицию index в списке рядов. Если series уже добавлен в список, он перемещается в новую index.

Примечание: При перемещении ряда в новую index, которая расположена после его старой индексации, новое положение в списке рассчитывается так, как если бы ряд всё ещё находился на его старой позиции, поэтому окончательная индекс фактически является index, уменьшенной на единицу.

См. также addSeries() и seriesList().

void Q3DBars::releaseAxis(QAbstract3DAxis *axis)

Возвращает владение axis обратно вызывающей стороне, если он добавлен на этот график. Если высвобождаемая axis используется, будет создана и активирована новая ось по умолчанию.

Если ось по умолчанию высвобождается и добавляется обратно позднее, она ведет себя как любая другая ось.

См. также addAxis(), setValueAxis(), setRowAxis() и setColumnAxis().

void Q3DBars::removeSeries(QBar3DSeries *series)

Удаляет series с графика.

QList<QBar3DSeries *> Q3DBars::seriesList() const

Возвращает список рядов, добавленных на этот график.

void Q3DBars::setColumnAxis(QCategory3DAxis *axis)

Устанавливает ось активного столбца на axis. Неявным образом вызывает addAxis() для передачи владения осью этому графику.

Если axis равно null, создается временная ось по умолчанию без меток. Эта временная ось уничтожается, если другая ось явно устанавливается для той же ориентации.

Примечание: Функция-сеттер для свойства columnAxis.

См. также columnAxis(), addAxis() и releaseAxis().

void Q3DBars::setPrimarySeries(QBar3DSeries *series)

Устанавливает series в качестве основного ряда графика. Основной ряд определяет метки осей строк и столбцов, когда метки не заданы явно для осей.

Если указанный ряд еще не добавлен на график, его установка в качестве основного ряда также неявным образом добавит его на график.

Если основной ряд удаляется с графика, это свойство сбрасывается к значению по умолчанию.

Если series равно null, это свойство сбрасывается к значению по умолчанию. По умолчанию устанавливается на первый добавленный ряд или на ноль, если ряды на графике отсутствуют.

Примечание: Функция-сеттер для свойства primarySeries.

См. также primarySeries().

void Q3DBars::setRowAxis(QCategory3DAxis *axis)

Устанавливает ось активной строки на axis. Неявным образом вызывает addAxis() для передачи владения осью этому графику.

Если axis равно null, создается временная ось по умолчанию без меток. Эта временная ось уничтожается, если другая ось явно устанавливается для той же ориентации.

Примечание: Функция-сеттер для свойства rowAxis.

См. также rowAxis(), addAxis() и releaseAxis().