Класс Q3DBars

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

Этот класс был представлен в QtDataVisualization 1.0.

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

Свойства

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

Сигналы

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

Этот класс позволяет разработчикам визуализировать столбчатые диаграммы в 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++ Classes.

Member Function Documentation

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().