Класс QAbstract3DGraph

Класс QAbstract3DGraph предоставляет окно и цикл отрисовки для графиков. Подробнее...

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

Типы публичного доступа

Свойства

• 16 свойств унаследовано от QWindow
• 1 свойство унаследовано от QObject

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

• 85 общедоступные функции, унаследованные от QWindow
• 145 общедоступные функции, унаследованные от QOpenGLFunctions
• 34 общедоступные функции, унаследованные от QObject
• 6 общедоступные функции, унаследованные от QSurface

Сигналы

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

Связанные нечлены

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

• 24 публичных слота, унаследованных от QWindow
• 1 публичный слот, унаследованный от QObject
• 1 публичная переменная, унаследованная от QWindow
• 1 публичная переменная, унаследованная от QObject
• 3 статических публичных членов, унаследованных от QWindow
• 10 статических публичных членов, унаследованных от QObject
• 18 защищенных функций, унаследованных от QWindow
• 9 защищенных функций, унаследованных от QObject
• 1 защищенный тип, унаследованный от QOpenGLFunctions
• 2 защищенных переменных, унаследованных от QObject
• 2 защищенных переменных, унаследованных от QSurface

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

Класс QAbstract3DGraph предоставляет окно и цикл отрисовки для графиков.

Этот класс является подклассом QWindow и предоставляет цикл отрисовки для графиков, наследующих его.

Вам, скорее всего, не придётся использовать этот класс напрямую, а вместо него один из его подклассов.

Активизация сглаживания по умолчанию включена в C++, за исключением сред OpenGL ES2, где сглаживание не поддерживается Qt Data Visualization. Чтобы указать нестандартное сглаживание для графика, укажите пользовательский формат поверхности в качестве параметра конструктора. Вы можете использовать удобную функцию QtDataVisualization::qDefaultSurfaceFormat() для создания объекта формата поверхности.

Примечание: QAbstract3DGraph устанавливает флаг окна Qt::FramelessWindowHint по умолчанию. Если вы хотите отображать окна графика как автономные окна с обычной рамкой, снимите этот флаг после создания графика. Например:

Q3DBars *graphWindow = new Q3DBars;
graphWindow->setFlags(graphWindow->flags() ^ Qt::FramelessWindowHint);

См. также Q3DBars, Q3DScatter, Q3DSurface и Qt Data Visualization C++ классы.

Документация типов членов

перечисление QAbstract3DGraph::ElementType

Тип элемента в графике.

Это перечисление было введено или изменено в QtDataVisualization 1.1.

перечисление QAbstract3DGraph::OptimizationHintфлаги QAbstract3DGraph::OptimizationHints

Флаги оптимизации рендеринга.

Это перечисление было введено или изменено в Qt Data Visualization 1.1.

Тип OptimizationHints является псевдонимом для QFlags<OptimizationHint>. Он хранит результат побитового ИЛИ комбинации значений OptimizationHint.

перечисление QAbstract3DGraph::SelectionFlagфлаги QAbstract3DGraph::SelectionFlags

Режимы выбора элементов. Значения этого перечисления можно комбинировать оператором ИЛИ.

Тип SelectionFlags является typedef для QFlags<SelectionFlag>. Он хранит логическое ИЛИ комбинацию значений SelectionFlag.

enum QAbstract3DGraph::ShadowQuality

Качество теней.

Документация по членам функций

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

Уничтожает QAbstract3DGraph.

int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

Добавляет QCustom3DItem item в график. График принимает во владение добавленный элемент.

Возвращает индекс добавленного элемента, если операция добавления прошла успешно, -1, если пытались добавить нулевой элемент, и индекс элемента, если пытались добавить уже добавленный элемент.

Элементы отрисовываются в порядке их вставки. Порядок отрисовки необходимо учитывать при наличии твердых и прозрачных элементов.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также removeCustomItems(), removeCustomItem(), removeCustomItemAt(), и customItems().

void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)

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

См. также releaseInputHandler() и setActiveInputHandler().

void QAbstract3DGraph::addTheme(Q3DTheme *theme)

Добавляет указанную тему theme в график. Темы, добавленные с помощью addTheme, не используются напрямую. Графику передается только владение темой. theme не должен быть нулевым или уже добавленным в другой график.

См. также releaseTheme() и setActiveTheme().

void QAbstract3DGraph::clearSelection()

Очищает выделение со всех присоединенных рядов.

QList<QCustom3DItem *> QAbstract3DGraph::customItems() const

Возвращает список всех добавленных пользовательских элементов.

Эта функция была добавлена в QtDataVisualization 1.2.

См. также addCustomItem().

bool QAbstract3DGraph::hasContext() const

Возвращает true, если контекст OpenGL графика был успешно инициализирован. Попытка использовать график при неудачной инициализации контекста обычно приводит к сбою. Распространенной причиной неудачной инициализации контекста является недостаточная поддержка платформой OpenGL.

QList<QAbstract3DInputHandler *> QAbstract3DGraph::inputHandlers() const

Возвращает список всех добавленных обработчиков событий.

См. также addInputHandler().

void QAbstract3DGraph::releaseCustomItem(QCustom3DItem *item)

Возвращает владение заданным элементом item и удаляет item из графика.

Примечание: Если тот же элемент добавляется обратно в график, необходимо переустановить текстуру или файл текстуры.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также QCustom3DItem::setTextureImage() и QCustom3DItem::setTextureFile().

void QAbstract3DGraph::releaseInputHandler(QAbstract3DInputHandler *inputHandler)

Освобождает владение обработчиком событий inputHandler обратно вызывающему объекту, если он был добавлен в этот график. Если выпущенный inputHandler используется, после этого вызова активного обработчика событий не будет.

Если обработчик событий по умолчанию выпущен и добавлен позже, он ведет себя как любой другой обработчик событий.

См. также addInputHandler() и setActiveInputHandler().

void QAbstract3DGraph::releaseTheme(Q3DTheme *theme)

Освобождает владение темой theme обратно вызывающему объекту, если она была добавлена в этот график. Если выпущенная тема используется, будет создана и активирована новая тема по умолчанию.

Если тема по умолчанию выпущенная и добавлена позже, она ведет себя как любая другая тема.

См. также addTheme() и setActiveTheme().

void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)

Удаляет пользовательский элемент item. Удаляет выделенные ресурсы.

Эта функция была добавлена в QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)

Удаляет все пользовательские элементы в позиции position. Удаляет выделенные ресурсы.

Эта функция была добавлена в QtDataVisualization 1.1.

void QAbstract3DGraph::removeCustomItems()

Удаляет все пользовательские элементы. Удаляет выделенные ресурсы.

Эта функция была добавлена в QtDataVisualization 1.1.

QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())

Отображает текущую кадр в изображение размером imageSize. Размер по умолчанию — размер окна. Изображение отображается с уровнем сглаживания, заданным в msaaSamples. Уровень по умолчанию — 0.

Возвращает отрисованное изображение.

Примечание: OpenGL ES2 не поддерживает сглаживание, поэтому msaaSamples всегда устанавливается в 0.

Эта функция была добавлена в QtDataVisualization 1.1.

QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const

Может быть использован для получения выделенной оси после получения сигнала selectedElementChanged с любым типом метки. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает указатель на выделенную ось или null.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const

Может быть использован для получения выделенного пользовательского элемента после получения сигнала selectedElementChanged с типом QAbstract3DGraph::ElementCustomItem. Владение элементом остается у графика. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает указатель на выделенный пользовательский элемент или null.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

int QAbstract3DGraph::selectedCustomItemIndex() const

Может быть использован для запроса индекса выделенного пользовательского элемента после получения сигнала selectedElementChanged с типом QAbstract3DGraph::ElementCustomItem. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает индекс выбранного пользовательского элемента или -1.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

int QAbstract3DGraph::selectedLabelIndex() const

Может быть использована для запроса индекса выделенной метки после получения сигнала selectedElementChanged с любым типом метки. Выделение действует до следующего сигнала selectedElementChanged.

Возвращает индекс выделенной метки или -1.

Эта функция была добавлена в QtDataVisualization 1.1.

См. также selectedElement.

void QAbstract3DGraph::setActiveInputHandler(QAbstract3DInputHandler *inputHandler)

Устанавливает inputHandler в качестве активного обработчика ввода для графика. Неявно вызывает addInputHandler() для передачи владения inputHandler этому графику.

Если inputHandler равен null, после вызова обработчик ввода не будет активен.

Примечание: Функция-сеттер для свойства activeInputHandler.

См. также activeInputHandler(), addInputHandler() и releaseInputHandler().

void QAbstract3DGraph::setActiveTheme(Q3DTheme *theme)

Устанавливает theme как активную тему для графика. Неявно вызывает addTheme() для передачи владения темой этому графику.

Если theme равен null, создаётся временная тема по умолчанию. Эта временная тема удаляется, если впоследствии явно устанавливается любая другая тема. Свойства темы можно изменять даже после её установки, и изменения вступают в силу немедленно.

Примечание: Функция-сеттер для свойства activeTheme.

См. также activeTheme().

[virtual] bool QAbstract3DGraph::shadowsSupported() const

Возвращает true если тени поддерживаются текущей конфигурацией. Конфигурации OpenGL ES2 не поддерживают тени.

QList<Q3DTheme *> QAbstract3DGraph::themes() const

Возвращает список всех добавленных тем.

См. также addTheme().

#include <QtDataVisualization/qutils.h>

// ...

Q3DBars *graph = new Q3DBars(QtDataVisualization::qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(QtDataVisualization::qDefaultSurfaceFormat());