QAbstract3DSeries 类
QAbstract3DSeries 类是所有 3D 数据系列的基类。 更多...
| 头文件 | #include <QAbstract3DSeries> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| 由以下实例化 | Abstract3DSeries |
| 继承 | QObject |
| 继承自 | |
| 状态 | 技术预览 |
- 所有成员列表，包括继承的成员
- QAbstract3DSeries 是 Qt Graphs C++ 3D 类的一部分。Qt Graphs C++ Classes for 3D.
公共类型
| 枚举类 | Mesh { UserDefined, Bar, Cube, Pyramid, Cone, …, Point } |
| 枚举类 | SeriesType { None, Bar, Scatter, Surface } |
属性
|
|
公共函数
| virtual | ~QAbstract3DSeries() override |
| QColor | baseColor() const |
| QLinearGradient | baseGradient() const |
| Q3DTheme::ColorStyle | colorStyle() const |
| bool | isItemLabelVisible() const |
| bool | isMeshSmooth() const |
| bool | isVisible() const |
| QString | 项目标签() |
| 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。
有关更多信息，请参阅 3D的Qt Graphs数据处理。
成员类型文档
枚举类 QAbstract3DSeries::Mesh
预定义网格类型。所有样式并非都可以与所有图表类型一起使用。
| 常数 | 值 | 描述 |
|---|---|---|
QAbstract3DSeries::Mesh::UserDefined | 0 | 用户定义的网格，通过 QAbstract3DSeries::userDefinedMesh 属性设置。 |
QAbstract3DSeries::Mesh::Bar | 1 | 基本的矩形条。 |
QAbstract3DSeries::Mesh::Cube | 2 | 基本的立方体。 |
QAbstract3DSeries::Mesh::Pyramid | 3 | 四面体金字塔。 |
QAbstract3DSeries::Mesh::Cone | 4 | 基本的圆锥。 |
QAbstract3DSeries::Mesh::Cylinder | 5 | 基本的圆柱。 |
QAbstract3DSeries::Mesh::BevelBar | 6 | 略带斜面（圆角）的矩形条。 |
QAbstract3DSeries::Mesh::BevelCube | 7 | 略带斜面（圆角）的立方体。 |
QAbstract3DSeries::Mesh::Sphere | 8 | 球体。 |
QAbstract3DSeries::Mesh::Minimal | 9 | 最小的3D网格：三角形金字塔。仅适用于 Q3DScatter。 |
QAbstract3DSeries::Mesh::Arrow | 10 | 向上指的箭头。 |
QAbstract3DSeries::Mesh::Point | 11 | 2D点。仅适用于 Q3DScatter。阴影不会影响此样式。不支持此样式的颜色样式 Q3DTheme::ColorStyle::ObjectGradient。 |
枚举类 QAbstract3DSeries::SeriesType
系列类型。
| 常数 | 值 | 描述 |
|---|---|---|
QAbstract3DSeries::SeriesType::None | 0 | 没有系列类型。 |
QAbstract3DSeries::SeriesType::Bar | 1 | 适用于 Q3DBars 的系列类型。 |
QAbstract3DSeries::SeriesType::Scatter | 2 | 适用于 Q3DScatter 的系列类型。 |
QAbstract3DSeries::SeriesType::Surface | 3 | 适用于 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。
[只读] itemLabel : const QString
此属性存储了格式化后的项目标签。
如果没有选中的项目，或者选中的项目不可见，则返回空字符串。
访问函数
| QString | 项目标签() |
通知信号
| void | itemLabelChanged(const QString &label) |
另请参阅itemLabelFormat。
itemLabelFormat : QString
此属性存储了此系列中数据项的标签格式。
此格式用于单个项目标签，例如，当一个项目被选中时。如何解释此格式取决于系列类型： QBar3DSeries、QScatter3DSeries、QSurface3DSeries。
访问函数
| QString | itemLabelFormat() const |
| void | setItemLabelFormat(const QString &format) |
通知信号
| void | itemLabelFormatChanged(const QString &format) |
itemLabelVisible : bool
此属性存储了图形中项目标签的可见性。
如果设置为 true，则在图形中以浮动标签的形式绘制项目标签。否则，不绘制项目标签。要在外部控件中显示项目标签，请将此属性设置为 false。默认值为 true。
访问函数
| bool | isItemLabelVisible() const |
| void | setItemLabelVisible(bool visible) |
通知信号
| void | itemLabelVisibilityChanged(bool visible) |
另请参阅itemLabelFormat 和 itemLabel。
mesh : QAbstract3DSeries::Mesh
此属性存储了系列中项目的大小。
对于 QSurface3DSeries，此属性存储 selection pointer。
如果网格是 MeshUserDefined，则必须设置 userDefinedMesh 属性，以便项目能够正确渲染。默认值取决于图形类型。
访问函数
| QAbstract3DSeries::Mesh | mesh() const |
| void | setMesh(QAbstract3DSeries::Mesh mesh) |
通知信号
| void | meshChanged(QAbstract3DSeries::Mesh mesh) |
meshRotation : QQuaternion
此属性存储应用于系列中所有项目的网格旋转。
旋转应是一个归一化的 QQuaternion。对于支持项目特定旋转的系列类型，旋转会相乘。 QBar3DSeries 忽略任何不是围绕 y 轴的旋转。 QSurface3DSeries 只将旋转应用于 selection pointer。默认值为无旋转。
访问函数
| 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.
[只读] type : const QAbstract3DSeries::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) |
成员函数文档
[override virtual noexcept] QAbstract3DSeries::~QAbstract3DSeries()
删除抽象3D系列。
[invokable] void QAbstract3DSeries::setMeshAxisAndAngle(const QVector3D &axis, float angle)
从 axis 和 angle 构造网格旋转四元数的便捷函数。
注：此函数可以通过元对象系统和从QML调用。请参阅Q_INVOKABLE。
另请参阅：meshRotation。
© 2024 Qt公司有限公司。本文件中包含的文档贡献是各自所有者的版权。本文件中提供的文档根据由自由软件基金会发布的GNU自由文档许可证版本1.3进行许可。Qt和相应的标志是芬兰以及/或其他国家的Qt公司拥有的商标。所有其他商标均为各自所有者的财产。
