Класс Q3DBars

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

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

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

Свойства

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

Сигналы

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

Этот класс позволяет разработчикам создавать трёхмерные гистограммы и просматривать их, свободно вращая сцену. Вращение осуществляется удерживанием правой кнопки мыши и перемещением мыши. Масштабирование осуществляется колесом мыши. Выбор, если включен, осуществляется левой кнопкой мыши. Сцену можно сбросить в стандартный вид камеры, щелкнув колесом мыши. На сенсорных устройствах вращение осуществляется касанием и перемещением, выбор — касанием и удержанием, а масштабирование — сжатием.

Если оси не установлены в 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>

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.

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

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.

Примечание: При перемещении ряда в новую 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().