Класс QAbstract3DGraph

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

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

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

Типы Public

Свойства

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

Сигналы

Связанные нечленные элементы

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

Этот класс наследуется от 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, объединённых оператором OR.

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

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

Тип SelectionFlags является псевдонимом для QFlags<SelectionFlag>. Он хранит комбинацию значений SelectionFlag, объединённых оператором OR.

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

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

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

[virtual] QAbstract3DGraph::~QAbstract3DGraph()

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

int QAbstract3DGraph::addCustomItem(QCustom3DItem *item)

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

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

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

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

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

void QAbstract3DGraph::addInputHandler(QAbstract3DInputHandler *inputHandler)

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

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

void QAbstract3DGraph::addTheme(Q3DTheme *theme)

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

См. также 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 вызывающей стороне, если он был добавлен на этот график. Если высвобождённый 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 значение 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());