Back to Qt.io
Contact Us Blog Download Qt
在本页

Scatter3DSeries QML Type

表示三维散点图中的数据序列。更多

Import Statement: import QtGraphs
In C++: QScatter3DSeries
Inherits:

Abstract3DSeries

Inherited By:

Spline3DSeries

属性

信号

方法

详细说明

该类型管理系列特定的可视化元素以及系列数据（通过数据代理）。

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 ，则不渲染系列。

信号文档

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.