Класс Q3DBars

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

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

Свойства

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

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

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

Сигналы

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

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

• 22 слотов, унаследованных от QWindow
• 1 слот, унаследованный от QObject
• 1 статический общедоступный член, унаследованный от QWindow
• 11 статических общедоступных членов, унаследованных от QObject
• 18 защищенных функций, унаследованных от QWindow
• 9 защищенных функций, унаследованных от QObject

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

Класс 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 = Q_NULLPTR, QWindow *parent = Q_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().