Scatter3DSeries QML Type (Uncreatable)
表示三维散点图中的数据序列。更多...
| Import Statement: | import QtGraphs |
| In C++: | QScatter3DSeries |
| Inherits: | |
| Inherited By: |
注意：此为不可创建的类型。无法在 QML 中实例化。
- 所有成员列表（包括继承的成员）
- Scatter3DSeries 属于Qt Graphs 的3D QML 类型。
属性
- baseColor : color
- baseGradient : Gradient
- colorStyle : GraphsTheme.ColorStyle
- dataArray : ScatterDataArray
- dataProxy : ScatterDataProxy
- invalidSelectionIndex : qsizetype
- itemLabel : string
- itemLabelFormat : string
- itemLabelVisible : bool
- itemSize : real
- lightingMode : Abstract3DSeries.LightingMode
(since 6.10) - mesh : Abstract3DSeries.Mesh
- meshRotation : quaternion
- meshSmooth : bool
- multiHighlightColor : color
- multiHighlightGradient : Gradient
- name : string
- selectedItem : qsizetype
- singleHighlightColor : color
- singleHighlightGradient : Gradient
- type : Abstract3DSeries.SeriesType
- userDefinedMesh : string
- visible : bool
信号
- baseColorChanged(color color)
- baseGradientChanged(Gradient gradient)
- colorStyleChanged(GraphsTheme.ColorStyle style)
- dataArrayChanged(ScatterDataArray array)
- dataProxyChanged(ScatterDataProxy proxy)
- itemLabelChanged(string label)
- itemLabelFormatChanged(string format)
- itemLabelVisibilityChanged(bool visible)
- itemSizeChanged(float size)
- 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)
- selectedItemChanged(qsizetype index)
- singleHighlightColorChanged(color color)
- singleHighlightGradientChanged(Gradient gradient)
- splineColorChanged(color color)
- splineKnottingChanged(real knotting)
- splineLoopingChanged(bool looping)
- splineResolutionChanged(int resolution)
- splineTensionChanged(real tension)
- splineVisibilityChanged(bool visible)
- userDefinedMeshChanged(string fileName)
- visibilityChanged(bool visible)
方法
- void setMeshAxisAndAngle(vector3d axis, real angle)
详细说明
此类用于管理系列特有的视觉元素以及系列数据（通过数据代理）。
Scatter3DSeries 支持以下用于 itemLabelFormat 的格式标签：
| @xTitle | 来自 x 轴的标题 |
| @yTitle | y 轴的标题 |
| @zTitle | z轴标题 |
| @xLabel | 使用 x 轴格式设置的项目值。有关更多信息，请参阅labelFormat 。 |
| @yLabel | 使用 y 轴格式设置的项目值。有关详细信息，请参阅labelFormat 。 |
| @zLabel | 项目值采用 z 轴的格式进行格式化。有关详细信息，请参阅labelFormat 。 |
| @seriesName | 系列名称 |
如需更完整的说明，请参阅QScatter3DSeries 。
另请参阅 Qt Graphs 中的“3D数据处理”。
属性文档
baseColor : color
该系列的基础色。
另请参阅 colorStyle 和GraphsTheme.seriesColors 。
baseGradient : Gradient
该系列的基数梯度。
另请参阅 colorStyle 。
colorStyle : GraphsTheme.ColorStyle
该系列的配色风格。
另请参阅 GraphsTheme.ColorStyle 。
dataArray : ScatterDataArray
保存对数据数组的引用。
dataArrayChanged 当数据数组被设置时，会触发该信号，除非newDataArray 与上一次设置的值完全相同。
注意：在 对数据数组进行任何操作之前， 必须先 为相关代理创建一个系列。
dataProxy : ScatterDataProxy
设置活动数据代理。该系列将接管其设置的任何代理，并在添加新代理时删除先前设置的代理。代理不能为空，也不能设置为另一个系列。
invalidSelectionIndex : qsizetype
一个常量属性，用于提供用于取消选择的无效索引。将此索引设置为selectedItem 属性，即可清除该系列中的选中项。
另请参阅 GraphsItem3D::clearSelection()。
itemLabel : string [read-only]
已格式化的项目标签。如果未选中任何项目，或者选中的项目不可见，则返回空字符串。
另请参阅 itemLabelFormat 。
itemLabelFormat : string
该系列中数据项的标签格式。此格式用于单个数据项的标签，例如当选中某项时。该格式的解释方式取决于系列类型。
另请参阅 Bar3DSeries 、Scatter3DSeries 以及Surface3DSeries 。
itemLabelVisible : bool
如果true ，项目标签将在图中作为浮动标签绘制。否则，不会绘制项目标签。若要在外部控件中显示项目标签，应将此属性设置为false 。默认值为true 。
另请参阅 itemLabelFormat 和itemLabel 。
itemSize : real
设置系列的项目大小。大小必须在0.0 和1.0 之间。将大小设置为0.0 时，项目大小会根据图表中所有系列的项目总数自动缩放。预设默认值为0.0 。
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 。
selectedItem : qsizetype
该系列数据数组中位于指定索引位置的条目。每次只能选中一个条目。若要清除该系列中的选中状态，需将invalidSelectionIndex 设为索引。如果将该系列添加到图表中，图表可根据用户交互或当选中状态失效时自动调整选中状态。 在另一个已添加的系列上选择项目也会清除当前的选择。从该系列中删除项目或在所选项目之前插入项目时，系统会调整选择范围，以确保该项目仍保持被选中状态。
另请参阅 GraphsItem3D::clearSelection()。
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 。
dataArrayChanged(ScatterDataArray array)
当dataArray 变为array 时，会触发此信号。
注意： 相应的处理程序 为onDataArrayChanged 。
dataProxyChanged(ScatterDataProxy proxy)
当dataProxy 变为proxy 时，会发出此信号。
注意： 相应的处理程序 是onDataProxyChanged 。
itemLabelChanged(string label)
当itemLabel 变为label 时，会触发此信号。
注意： 相应的处理程序 是onItemLabelChanged 。
itemLabelFormatChanged(string format)
当itemLabelFormat 变为format 时，会触发此信号。
注意： 对应的处理程序 是onItemLabelFormatChanged 。
itemLabelVisibilityChanged(bool visible)
当 itemLabelVisibility 变为visible 时，会触发此信号。
注意： 相应的处理程序 为onItemLabelVisibilityChanged 。
itemSizeChanged(float size)
当itemSize 变为size 时，会触发此信号。
注意： 对应的处理程序 是onItemSizeChanged 。
[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 。
selectedItemChanged(qsizetype index)
当selectedItem 变为index 时，会触发此信号。
注意： 相应的处理程序 是onSelectedItemChanged 。
singleHighlightColorChanged(color color)
当singleHighlightColor 变为color 时，会触发此信号。
注意： 相应的处理程序 是onSingleHighlightColorChanged 。
singleHighlightGradientChanged(Gradient gradient)
当singleHighlightGradient 变为gradient 时，会触发此信号。
注意： 相应的处理程序 是onSingleHighlightGradientChanged 。
splineColorChanged(color color)
当 splineColor 变为color 时，会触发此信号。
注意： 相应的处理程序 为onSplineColorChanged 。
splineKnottingChanged(real knotting)
当 splineKnotting 变为knotting 时，会触发此信号。
注意： 相应的处理程序 为onSplineKnottingChanged 。
splineLoopingChanged(bool looping)
当 splineLooping 属性从 `looping` 发生变化时，会触发此信号。
注意： 相应的处理程序 是onSplineLoopingChanged 。
splineResolutionChanged(int resolution)
当 splineResolution 变为resolution 时，会触发此信号。
注意： 相应的处理程序 为onSplineResolutionChanged 。
splineTensionChanged(real tension)
当 splineTension 的值变为tension 时，会触发此信号。
注意： 相应的处理程序 为onSplineTensionChanged 。
splineVisibilityChanged(bool visible)
当 splineVisible 变为visible 时，会触发此信号。
注意： 相应的处理程序 为onSplineVisibilityChanged 。
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.
