Класс QAbstract3DSeries
Класс QAbstract3DSeries — базовый класс для всех серий данных. Подробнее...
| Заголовок: | #include <QAbstract3DSeries> |
| С момента: | QtDataVisualization 1.0 |
| Создается с помощью: | Abstract3DSeries |
| Наследует от: | QObject |
| Наследуется: |
Открытые типы
| Перечисление | Mesh { MeshUserDefined, MeshBar, MeshCube, MeshPyramid, MeshCone, …, MeshPoint } |
| Перечисление | SeriesType { SeriesTypeNone, SeriesTypeBar, SeriesTypeScatter, SeriesTypeSurface } |
Свойства
|
|
Открытые функции
| virtual | ~QAbstract3DSeries() |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | itemLabel() const |
| QString | itemLabelFormat() const |
| QAbstract3DSeries::Mesh | mesh() const |
| QQuaternion | meshRotation() const |
| QColor | multiHighlightColor() const |
| QLinearGradient | multiHighlightGradient() const |
| QString | name() const |
| void | setBaseColor(const QColor &color) |
| void | setBaseGradient(const QLinearGradient &gradient) |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
| void | setItemLabelFormat(const QString &format) |
| void | setItemLabelVisible(bool visible) |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
| void | setMeshAxisAndAngle(const QVector3D &axis, float angle) |
| void | setMeshRotation(const QQuaternion &rotation) |
| void | setMeshSmooth(bool enable) |
| void | setMultiHighlightColor(const QColor &color) |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
| void | setName(const QString &name) |
| void | setSingleHighlightColor(const QColor &color) |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
| void | setUserDefinedMesh(const QString &fileName) |
| void | setVisible(bool visible) |
| QColor | singleHighlightColor() const |
| QLinearGradient | singleHighlightGradient() const |
| QAbstract3DSeries::SeriesType | type() const |
| QString | userDefinedMesh() const |
Сигналы
| void | baseColorChanged(const QColor &color) |
| void | baseGradientChanged(const QLinearGradient &gradient) |
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
| void | itemLabelChanged(const QString &label) |
| void | itemLabelFormatChanged(const QString &format) |
| void | itemLabelVisibilityChanged(bool visible) |
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
| void | meshRotationChanged(const QQuaternion &rotation) |
| void | meshSmoothChanged(bool enabled) |
| void | multiHighlightColorChanged(const QColor &color) |
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
| void | nameChanged(const QString &name) |
| void | singleHighlightColorChanged(const QColor &color) |
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
| void | userDefinedMeshChanged(const QString &fileName) |
| void | visibilityChanged(bool visible) |
Подробное описание
Существуют наследуемые классы для каждого поддерживаемого типа серии: QBar3DSeries, QScatter3DSeries и QSurface3DSeries.
Дополнительную информацию см. в разделе Qt Data Visualization Обработка данных.
Документация по типам членов
перечисление QAbstract3DSeries::Mesh
Предопределённые типы сетки. Не все стили могут использоваться со всеми типами визуализации.
| Константа | Значение | Описание |
|---|---|---|
QAbstract3DSeries::MeshUserDefined |
0 |
Пользовательская сетка, задаваемая свойством QAbstract3DSeries::userDefinedMesh. |
QAbstract3DSeries::MeshBar |
1 |
Базовая прямоугольная диаграмма. |
QAbstract3DSeries::MeshCube |
2 |
Базовая куба. |
QAbstract3DSeries::MeshPyramid |
3 |
Четырехугольная пирамида. |
QAbstract3DSeries::MeshCone |
4 |
Базовый конус. |
QAbstract3DSeries::MeshCylinder |
5 |
Базовый цилиндр. |
QAbstract3DSeries::MeshBevelBar |
6 |
Несколько сглаженная (закругленная) прямоугольная диаграмма. |
QAbstract3DSeries::MeshBevelCube |
7 |
Несколько сглаженная (закругленная) куба. |
QAbstract3DSeries::MeshSphere |
8 |
Сфера. |
QAbstract3DSeries::MeshMinimal |
9 |
Минимальная 3D-сетка: треугольная пирамида. Используется только с Q3DScatter. |
QAbstract3DSeries::MeshArrow |
10 |
Стрелка, направленная вверх. |
QAbstract3DSeries::MeshPoint |
11 |
2D точка. Используется только с Q3DScatter. Тени не влияют на этот стиль. Стиль цвета Q3DTheme::ColorStyleObjectGradient не поддерживается этим стилем. |
перечисление QAbstract3DSeries::SeriesType
Тип серии.
| Константа | Значение | Описание |
|---|---|---|
QAbstract3DSeries::SeriesTypeNone |
0 |
Тип серии отсутствует. |
QAbstract3DSeries::SeriesTypeBar |
1 |
Тип серии для Q3DBars. |
QAbstract3DSeries::SeriesTypeScatter |
2 |
Тип серии для Q3DScatter. |
QAbstract3DSeries::SeriesTypeSurface |
4 |
Тип серии для Q3DSurface. |
Документация свойств
baseColor : QColor
Это свойство хранит базовый цвет ряда.
Функции доступа:
| QColor | baseColor() const |
| void | setBaseColor(const QColor &color) |
Сигнал уведомления:
| void | baseColorChanged(const QColor &color) |
См. также colorStyle и Q3DTheme::baseColors.
baseGradient : QLinearGradient
Это свойство хранит базовый градиент ряда.
Функции доступа:
| QLinearGradient | baseGradient() const |
| void | setBaseGradient(const QLinearGradient &gradient) |
Сигнал уведомления:
| void | baseGradientChanged(const QLinearGradient &gradient) |
См. также colorStyle и Q3DTheme::baseGradients.
colorStyle : Q3DTheme::ColorStyle
Это свойство хранит стиль цвета для ряда.
Функции доступа:
| Q3DTheme::ColorStyle | colorStyle() const |
| void | setColorStyle(Q3DTheme::ColorStyle style) |
Сигнал уведомления:
| void | colorStyleChanged(Q3DTheme::ColorStyle style) |
См. также Q3DTheme::ColorStyle.
[read-only, since QtDataVisualization 1.1] itemLabel : const QString
Это свойство хранит отформатированное метку элемента.
Если нет выделенного элемента или выделенный элемент невидим, возвращает пустую строку.
Это свойство было добавлено в QtDataVisualization 1.1.
Функции доступа:
| QString | itemLabel() const |
Сигнал уведомления:
| void | itemLabelChanged(const QString &label) |
См. также itemLabelFormat.
itemLabelFormat : QString
Это свойство хранит формат метки для элементов данных в этом ряду.
Этот формат используется для меток отдельных элементов, например, при выделении элемента. Способ интерпретации формата зависит от типа ряда: QBar3DSeries, QScatter3DSeries, QSurface3DSeries.
Функции доступа:
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
Сигнал уведомления:
| void | itemLabelFormatChanged(const QString &format) |
[since QtDataVisualization 1.1] itemLabelVisible : bool
Это свойство хранит видимость меток элементов на графике.
Если true, метки элементов отображаются как плавающие метки на графике. В противном случае, метки элементов не отображаются. Для отображения метки элемента в внешнем элементе управления, это свойство устанавливается в false. По умолчанию true.
Это свойство было добавлено в QtDataVisualization 1.1.
Функции доступа:
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
Сигнал уведомления:
| void | itemLabelVisibilityChanged(bool visible) |
См. также itemLabelFormat и itemLabel.
mesh : Mesh
Это свойство хранит сетку элементов в ряду.
Для QSurface3DSeries, это свойство хранит указатель выделения.
Если сетка MeshUserDefined, тогда свойство userDefinedMesh также должно быть установлено, чтобы элементы отображались корректно. Значение по умолчанию зависит от типа графика.
Функции доступа:
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
Сигнал уведомления:
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
Это свойство хранит вращение сетки, которое применяется ко всем элементам ряда.
Вращение должно быть нормализованным QQuaternion. Для тех типов рядов, которые поддерживают вращение отдельных элементов, вращения умножаются вместе. QBar3DSeries игнорирует любое вращение, которое не выполняется вокруг оси y. QSurface3DSeries применяет вращение только к указателю выделения. Значение по умолчанию — отсутствие вращения.
Функции доступа:
| QQuaternion | meshRotation() const |
| void | setMeshRotation(const QQuaternion &rotation) |
Сигнал уведомления:
| void | meshRotationChanged(const QQuaternion &rotation) |
meshSmooth : bool
Это свойство хранит, используются ли сглаженные версии предопределенных сеток.
Если true, используются сглаженные версии, установленные через свойство mesh. Это свойство не влияет на пользовательские сетки, используемые, когда сетка установлена в MeshUserDefined. Значение по умолчанию false.
Функции доступа:
| bool | isMeshSmooth() const |
| void | setMeshSmooth(bool enable) |
Сигнал уведомления:
| void | meshSmoothChanged(bool enabled) |
multiHighlightColor : QColor
Это свойство хранит цвет выделения нескольких элементов ряда.
Функции доступа:
| QColor | multiHighlightColor() const |
| void | setMultiHighlightColor(const QColor &color) |
Сигнал уведомления:
| void | multiHighlightColorChanged(const QColor &color) |
См. также colorStyle и Q3DTheme::multiHighlightColor.
multiHighlightGradient : QLinearGradient
Это свойство хранит градиент выделения нескольких элементов ряда.
Функции доступа:
| QLinearGradient | multiHighlightGradient() const |
| void | setMultiHighlightGradient(const QLinearGradient &gradient) |
Сигнал уведомления:
| void | multiHighlightGradientChanged(const QLinearGradient &gradient) |
См. также colorStyle и Q3DTheme::multiHighlightGradient.
name : QString
Это свойство содержит имя ряда.
Имя ряда можно использовать в формате метки элемента с тегом @seriesName.
Функции доступа:
| QString | name() const |
| void | setName(const QString &name) |
Сигнал уведомления:
| void | nameChanged(const QString &name) |
См. также itemLabelFormat.
singleHighlightColor : QColor
Это свойство содержит цвет выделения одного элемента ряда.
Функции доступа:
| QColor | singleHighlightColor() const |
| void | setSingleHighlightColor(const QColor &color) |
Сигнал уведомления:
| void | singleHighlightColorChanged(const QColor &color) |
См. также colorStyle и Q3DTheme::singleHighlightColor.
singleHighlightGradient : QLinearGradient
Это свойство содержит градиент выделения одного элемента ряда.
Функции доступа:
| QLinearGradient | singleHighlightGradient() const |
| void | setSingleHighlightGradient(const QLinearGradient &gradient) |
Сигнал уведомления:
| void | singleHighlightGradientChanged(const QLinearGradient &gradient) |
См. также colorStyle и Q3DTheme::singleHighlightGradient.
[read-only] type : const SeriesType
Это свойство содержит тип ряда.
Функции доступа:
| QAbstract3DSeries::SeriesType | type() const |
userDefinedMesh : QString
Это свойство содержит имя файла пользовательской настраиваемой сетки объектов.
Пользовательская сетка используется, когда mesh является MeshUserDefined.
Примечание: Файл должен быть в формате Wavefront OBJ и содержать вершины, нормали и UV-координаты. Он также должен быть треугольным.
Функции доступа:
| QString | userDefinedMesh() const |
| void | setUserDefinedMesh(const QString &fileName) |
Сигнал уведомления:
| void | userDefinedMeshChanged(const QString &fileName) |
visible : bool
Это свойство содержит видимость ряда.
Если это свойство false, ряд не отображается. По умолчанию true.
Функции доступа:
| bool | isVisible() const |
| void | setVisible(bool visible) |
Сигнал уведомления:
| void | visibilityChanged(bool visible) |
Документация по функциям-членам
[virtual] QAbstract3DSeries::~QAbstract3DSeries()
Удаляет абстрактный 3D ряд.
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)
Функция удобства для построения кватерниона вращения сетки из axis и angle.
Примечание: Эта функция может вызываться через систему метаобъектов и из QML. См. Q_INVOKABLE.
См. также meshRotation.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-6.1/qabstract3dseries.html