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

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

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)

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

[virtual] Q3DBars::~Q3DBars()

Уничтожает 3D столбчатой график.

void Q3DBars::addAxis(QAbstract3DAxis *axis)

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

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

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