PySide6.QtGraphs.QScatter3DSeries¶

class QScatter3DSeries¶

QScatter3DSeries 类表示3D散点图中的数据系列。更多…

概要¶

属性¶

• dataArrayᅟ - 系列的数据数组

• dataProxyᅟ - 活跃的数据代理

• itemSizeᅟ - 系列的项大小

• selectedItemᅟ - 系列中被选中的项目

方法¶

• def __init__()

• def clearArray()

• def dataArray()

• def dataProxy()

• def itemSize()

• def selectedItem()

• def setDataArray()

• def setDataProxy()

• def setItemSize()

• def setSelectedItem()

信号¶

• def dataArrayChanged()

• def dataProxyChanged()

• def itemSizeChanged()

• def selectedItemChanged()

静态函数¶

• def invalidSelectionIndex()

注意

本文档可能包含从C++自动翻译到Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译问题，您也可以通过在我们的https:/bugreports.qt.io/projects/PYSIDE上创建工单来告知我们。

详细描述¶

警告

本节包含从C++自动翻译到Python的代码片段，可能包含错误。

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

关于代理系列关系，强调几个关键点至关重要。在这种情况下，数据存储在系列中，用户可以通过系列访问数据集。这个系列由代理对象控制或表示。因此，代理可以用来管理数据的各种操作并更新实际数据集。然而，有必要创建一个与此代理关联的系列来编辑数据集。

如果没有为系列显式设置数据代理，系列将创建一个默认代理。设置另一个代理将销毁现有的代理以及添加到系列中的所有数据。

QScatter3DSeries 支持以下格式标签用于 setItemLabelFormat() ：

@xTitle	X轴标题
@yTitle	Y轴标题
@zTitle	来自z轴的标题
@xLabel	使用x轴格式格式化的项目值。有关更多信息，请参见labelFormat。
@yLabel	使用y轴格式格式化的项目值。有关更多信息，请参见labelFormat。
@zLabel	使用z轴格式格式化的项目值。有关更多信息，请参阅labelFormat。
@seriesName	系列名称

例如：

proxy.setItemLabelFormat("@yTitle for (@xLabel, @zLabel): %.1f")

另请参阅

使用3D处理Qt图形数据

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property dataArrayᅟ: list of QScatterDataItem¶

此属性保存系列的数据数组。

保存对数据数组的引用。

当数据数组被设置时，会发出dataArrayChanged信号，除非newDataArray与之前的相同。

注意

在对数据数组进行任何操作之前，必须为相关代理创建一个系列。

另请参阅

clearArray()

Access functions:

• dataArray()

• setDataArray()

• 信号 dataArrayChanged()

property dataProxyᅟ: QScatterDataProxy¶

此属性保存活动数据代理。

将系列的活动数据代理设置为proxy。系列将拥有任何设置给它的代理，并在添加新代理时删除之前设置的任何代理。proxy参数不能为空或设置为另一个系列。

Access functions:

• dataProxy()

• setDataProxy()

• 信号 dataProxyChanged()

property itemSizeᅟ: float¶

此属性保存系列的项目大小。

大小必须在0.0f和1.0f之间。将大小设置为0.0f会导致项目大小根据图表中所有系列的项目总数自动缩放。

预设的默认值是 0.0f。

Access functions:

• itemSize()

• setItemSize()

• 信号 itemSizeChanged()

property selectedItemᅟ: int¶

此属性保存系列中选中的项目。

选择系列数据数组中索引为index的项目。一次只能选择一个项目。

要清除此系列中的选择，invalidSelectionIndex() 被设置为 index。如果将此系列添加到图表中，图表可以根据用户交互或选择无效时调整选择。选择另一个添加系列中的项目也会清除选择。

在所选项目之前从系列中删除项目或插入项目将调整选择，以便相同的项目将保持选中状态。

另请参阅

clearSelection()

Access functions:

• selectedItem()

• setSelectedItem()

• 信号 selectedItemChanged()

__init__([parent=None])¶

Parameters:

父对象 – QObject

使用父级 parent 构建一个3D散点系列。

__init__(dataProxy[, parent=None])

Parameters:

• dataProxy – QScatterDataProxy

• parent – QObject

使用数据代理 dataProxy 和父级 parent 构建一个3D散点系列。

clearArray()¶

清除数据数组。

dataArray()¶

Return type:

QScatterDataItem的列表

属性 dataArrayᅟ 的获取器。

dataArrayChanged(array)¶

Parameters:

array – QScatterDataItem 的列表

属性 dataArrayᅟ 的通知信号。

dataProxy()¶

Return type:

QScatterDataProxy

另请参阅

setDataProxy()

属性 dataProxyᅟ 的获取器。

dataProxyChanged(proxy)¶

Parameters:

proxy – QScatterDataProxy

属性 dataProxyᅟ 的通知信号。

static invalidSelectionIndex()¶

Return type:

整数

返回一个无效的索引以供选择。此索引设置为selectedItem属性，以清除此系列中的选择。

另请参阅

clearSelection()

itemSize()¶

Return type:

浮点数

另请参阅

setItemSize()

属性 itemSizeᅟ 的获取器。

itemSizeChanged(size)¶

Parameters:

size – 浮点数

属性 itemSizeᅟ 的通知信号。

selectedItem()¶

Return type:

整数

另请参阅

setSelectedItem()

属性 selectedItemᅟ 的获取器。

selectedItemChanged(index)¶

Parameters:

索引 – int

属性 selectedItemᅟ 的通知信号。

setDataArray(newDataArray)¶

Parameters:

newDataArray – QScatterDataItem 的列表

另请参阅

dataArray()

属性 dataArrayᅟ 的设置器。

setDataProxy(proxy)¶

Parameters:

proxy – QScatterDataProxy

另请参阅

dataProxy()

属性 dataProxyᅟ 的设置器。

setItemSize(size)¶

Parameters:

size – 浮点数

另请参阅

itemSize()

属性 itemSizeᅟ 的设置器。

setSelectedItem(index)¶

Parameters:

索引 – int

另请参阅

selectedItem()

属性 selectedItemᅟ 的设置器。