Класс Q3DBars

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

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

Свойства

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

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

• 54 открытых функций, унаследованных от QAbstract3DGraph
• 82 открытых функции, унаследованных от QWindow
• 145 открытых функций, унаследованных от QOpenGLFunctions
• 31 открытых функций, унаследованных от QObject
• 6 открытых функций, унаследованных от QSurface

Сигналы

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

Статические открытые члены

• 1 статический открытый член, унаследованный от QWindow
• 9 статических открытых членов, унаследованных от QObject

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

• 24 открытых слота, унаследованных от QWindow
• 1 открытый слот, унаследованный от 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 = 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().