Abstract3DSeries QML Type (Uncreatable)
所有 3D 数据序列的基础类型。更多...
| Import Statement: | import QtGraphs |
| In C++: | QAbstract3DSeries |
| Inherited By: | Bar3DSeries, Scatter3DSeries, Spline3DSeries, and Surface3DSeries |
注意：这是一个不可创建的类型。无法在 QML 中实例化。
- 所有成员列表（包括继承的成员）
- Abstract3DSeries 属于Qt Graphs QML 3D 类型。
属性
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
信号
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
(since 6.10) - meshChanged(Abstract3DSeries.Mesh mesh)
- meshRotationChanged(quaternion rotation)
- meshSmoothChanged(bool enabled)
- multiHighlightColorChanged(color color)
- multiHighlightGradientChanged(Gradient gradient)
- nameChanged(string name)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
方法
- void setMeshAxisAndAngle(vector3d axis, real angle)
详细说明
该抽象类是以下子类的基类：Bar3DSeries 、Scatter3DSeries 和Surface3DSeries 。
有关更多信息，请参阅《Qt Graphs ：3D数据处理》。
属性文档
baseColor : color
该系列的基础色。
另请参阅 colorStyle 和GraphsTheme.seriesColors 。
baseGradient : Gradient
该系列的基数梯度。
另请参阅 colorStyle 。
colorStyle : GraphsTheme.ColorStyle
该系列的配色风格。
另请参阅 GraphsTheme.ColorStyle 。
itemLabel : string [read-only]
已格式化的项目标签。如果未选中任何项目，或者所选项目不可见，则返回空字符串。
另请参阅 itemLabelFormat 。
itemLabelFormat : string
该系列中数据项的标签格式。此格式用于单个数据项的标签，例如在选中某项时。该格式的解释方式取决于系列类型。
另请参阅 Bar3DSeries 、Scatter3DSeries 以及Surface3DSeries 。
itemLabelVisible : bool
如果true ，项目标签将在图中作为浮动标签绘制。否则，项目标签不会被绘制。若要在外部控件中显示项目标签，应将此属性设置为false 。默认值为true 。
另请参阅 itemLabelFormat 和itemLabel 。
lightingMode : Abstract3DSeries.LightingMode [since 6.10]
该系列中项目的照明模式。默认值为QAbstract3DSeries::LightingMode::Shaded
该属性自 Qt 6.10 起引入。
另请参阅 QAbstract3DSeries::LightingMode 。
mesh : Abstract3DSeries.Mesh
该系列中各项的网格，或者在Surface3DSeries 的情况下为选择指针。如果网格为Abstract3DSeries.Mesh.UserDefined ，则必须同时设置userDefinedMesh 属性，以便各项能正确渲染。默认值取决于图形类型。
另请参阅 QAbstract3DSeries::Mesh 。
meshRotation : quaternion
应用于该系列所有项的网格旋转。旋转应为归一化四元数。对于支持针对单个项进行旋转的系列类型，各项的旋转值将相互乘积。Bar3DSeries 会忽略任何非围绕 y 轴的旋转。Surface3DSeries 仅将旋转应用于选择指针。默认不进行旋转。
meshSmooth : bool
如果true ，则使用通过mesh 属性设置的预定义网格的平滑版本。当网格设置为Abstract3DSeries.Mesh.UserDefined 时，此属性不会影响所使用的自定义网格。默认值为false 。
multiHighlightColor : color
该系列中多个项目的突出显示颜色。
另请参阅 colorStyle 和GraphsTheme.multiHighlightColor 。
multiHighlightGradient : Gradient
该系列中多个项目的渐变高亮效果。
另请参阅 colorStyle 和GraphsTheme.multiHighlightGradient 。
name : string
系列名称。可使用标签@seriesName 以项目标签格式显示。
另请参阅 itemLabelFormat 。
singleHighlightColor : color
该系列的单件商品高亮颜色。
另请参阅 colorStyle 和GraphsTheme.singleHighlightColor 。
singleHighlightGradient : Gradient
该系列中单件商品的渐变高光效果。
另请参阅 colorStyle 和GraphsTheme.singleHighlightGradient 。
type : Abstract3DSeries.SeriesType [read-only]
序列的类型。QAbstract3DSeries::SeriesType 中的一个值。
userDefinedMesh : string
当使用mesh 时，对象的用户自定义网格文件名为Abstract3DSeries.Mesh.UserDefined 。
注意：该文件 必须采用QtQuick3D 网格格式。请使用balsam 转换工具，将其他 3D 模型格式转换为网格。
visible : bool
该系列的可见性。如果false ，则该系列不会被渲染。
Signal 文档
baseColorChanged(color color)
当baseColor 变为color 时，会发出此信号。
注意： 相应的处理程序 是onBaseColorChanged 。
baseGradientChanged(Gradient gradient)
当baseGradient 变为gradient 时，会触发此信号。
注意： 相应的处理程序 是onBaseGradientChanged 。
colorStyleChanged(GraphsTheme.ColorStyle style)
当colorStyle 变为style 时，会触发此信号。
注意： 相应的处理程序 是onColorStyleChanged 。
itemLabelChanged(string label)
当itemLabel 变为label 时，将发出此信号。
注意： 相应的处理程序 是onItemLabelChanged 。
itemLabelFormatChanged(string format)
当itemLabelFormat 变为format 时，会触发此信号。
注意： 相应的处理程序 是onItemLabelFormatChanged 。
itemLabelVisibilityChanged(bool visible)
当 itemLabelVisibility 变为visible 时，会触发此信号。
注意： 相应的处理程序 为onItemLabelVisibilityChanged 。
[since 6.10] lightingModeChanged(Abstract3DSeries.LightingMode lightingMode)
当lightingMode 变为lightingMode 时，会触发此信号。
注意： 相应的处理程序 是onLightingModeChanged 。
该信号在 Qt 6.10 中引入。
meshChanged(Abstract3DSeries.Mesh mesh)
当mesh 变为mesh 时，会触发此信号。
注意： 相应的处理程序 为onMeshChanged 。
meshRotationChanged(quaternion rotation)
当meshRotation 变为rotation 时，会发出此信号。
注意： 相应的处理程序 为onMeshRotationChanged 。
meshSmoothChanged(bool enabled)
当meshSmooth 变为enabled 时，会触发此信号。
注意： 相应的处理程序 是onMeshSmoothChanged 。
multiHighlightColorChanged(color color)
当multiHighlightColor 变为color 时，会触发此信号。
注意： 相应的处理程序 是onMultiHighlightColorChanged 。
multiHighlightGradientChanged(Gradient gradient)
当multiHighlightGradient 变为gradient 时，会触发此信号。
注意： 相应的处理程序 是onMultiHighlightGradientChanged 。
nameChanged(string name)
当name 变为name 时，会触发此信号。
注意： 相应的处理程序 是onNameChanged 。
singleHighlightColorChanged(color color)
当singleHighlightColor 变为color 时，会触发此信号。
注意： 相应的处理程序 是onSingleHighlightColorChanged 。
singleHighlightGradientChanged(Gradient gradient)
当singleHighlightGradient 变为gradient 时，将触发此信号。
注意： 相应的处理程序 是onSingleHighlightGradientChanged 。
userDefinedMeshChanged(string fileName)
当userDefinedMesh 变为fileName 时，会触发此信号。
注意： 相应的处理程序 是onUserDefinedMeshChanged 。
visibilityChanged(bool visible)
当该系列的可见性变为“visible ”时，会发出此信号。
注意： 相应的处理程序 为onVisibilityChanged 。
方法文档
void setMeshAxisAndAngle(vector3d axis, real angle)
一个便捷函数，用于根据axis 和angle 构建网格旋转四元数。
另请参阅 meshRotation 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
