Класс Q3DBars

Класс 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);

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

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

bars.show();

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

#include <QtDataVisualization>

int main(int argc, char **argv)
{
    qputenv("QSG_RHI_BACKEND", "opengl");
    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++ Classes.

Описание функций-членов

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

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

[virtual] Q3DBars::~Q3DBars()

Уничтожает трёхмерный столбчатый график.

void Q3DBars::addAxis(QAbstract3DAxis *axis)

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

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

void Q3DBars::addSeries(QBar3DSeries *series)

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

См. также 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().