Класс QAbstract3DGraph

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

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

Общедоступные типы

Свойства

Общедоступные функции

Сигналы

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

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

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

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

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

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

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

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

[since QtDataVisualization 1.1] перечисление QAbstract3DGraph::ElementType

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

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

[since Qt Data Visualization 1.1] перечисление QAbstract3DGraph::OptimizationHintфлаги QAbstract3DGraph::OptimizationHints

Подсказка для оптимизации отрисовки.

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

Тип OptimizationHints — это псевдоним для QFlags<OptimizationHint>. Он хранит результат объединения по оператору OR значений OptimizationHint.

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

Режимы выбора элементов. Значения этого перечисления могут быть объединены с помощью оператора OR.

Тип SelectionFlags — это псевдоним для QFlags<SelectionFlag>. Он хранит результат объединения по оператору OR значений SelectionFlag.

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

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

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

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

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

[since QtDataVisualization 1.1] 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)

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

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

void QAbstract3DGraph::clearSelection()

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

[since QtDataVisualization 1.2] QList<QCustom3DItem *> QAbstract3DGraph::customItems() const

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

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

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

bool QAbstract3DGraph::hasContext() const

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

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

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

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

[since QtDataVisualization 1.1] 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)

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

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

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

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItem(QCustom3DItem *item)

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

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

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItemAt(const QVector3D &position)

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

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

[since QtDataVisualization 1.1] void QAbstract3DGraph::removeCustomItems()

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

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

[since QtDataVisualization 1.1] QImage QAbstract3DGraph::renderToImage(int msaaSamples = 0, const QSize &imageSize = QSize())

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

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

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

[since QtDataVisualization 1.1] QAbstract3DAxis *QAbstract3DGraph::selectedAxis() const

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] QCustom3DItem *QAbstract3DGraph::selectedCustomItem() const

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] int QAbstract3DGraph::selectedCustomItemIndex() const

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

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

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

См. также selectedElement.

[since QtDataVisualization 1.1] 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(qDefaultSurfaceFormat(false));

#include <QtDataVisualization/qutils.h>

// ...

QQuickView viewer;
viewer.setFormat(qDefaultSurfaceFormat(true));