QScatter3DSeries Class
QScatter3DSeries 类表示三维散点图中的数据序列。更多内容...
| 头文件： | #include <QScatter3DSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake： | QT += datavisualization |
| 自： | QtDataVisualization 1.0 |
| 在 QML 中： | Scatter3DSeries |
| 继承自： | QAbstract3DSeries |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
公共函数
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() |
| QScatterDataProxy * | dataProxy() const |
| float | itemSize() const |
| int | selectedItem() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
| void | setItemSize(float size) |
| void | setSelectedItem(int index) |
信号
| void | dataProxyChanged(QScatterDataProxy *proxy) |
| void | itemSizeChanged(float size) |
| void | selectedItemChanged(int index) |
静态公共成员
| int | invalidSelectionIndex() |
详细说明
该类负责管理序列特有的视觉元素，以及序列数据（通过数据代理）。
如果未为该系列显式设置数据代理，则该系列将创建一个默认代理。设置另一个代理将销毁现有的代理及其中的所有数据。
QScatter3DSeries 支持以下用于 `QAbstract3DSeries::setItemLabelFormat()` 的格式标签：
| @xTitle | 来自 x 轴的标题 |
| @yTitle | y 轴标题 |
| @zTitle | z轴标题 |
| @xLabel | 使用x轴格式格式化的项目值。有关详细信息，请参阅QValue3DAxis::setLabelFormat()。 |
| @yLabel | 使用 y 轴格式进行格式化的项目值。有关详细信息，请参阅QValue3DAxis::setLabelFormat()。 |
| @zLabel | 项目值采用 z 轴的格式进行格式化。有关详细信息，请参阅QValue3DAxis::setLabelFormat()。 |
| @seriesName | 系列名称 |
例如：
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));另请参阅 Qt Data Visualization 数据处理。
属性文档
dataProxy : QScatterDataProxy*
该属性保存活动数据代理。
访问函数：
| QScatterDataProxy * | dataProxy() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
通知信号：
| void | dataProxyChanged(QScatterDataProxy *proxy) |
itemSize : float
该系列的条目大小。
大小必须在0.0f 和1.0f 之间。将大小设置为0.0f 会导致项目大小根据图表中所有系列的项目总数自动缩放。
预设默认值为0.0f 。
访问函数：
| float | itemSize() const |
| void | setItemSize(float size) |
通知信号：
| void | itemSizeChanged(float size) |
selectedItem : int
该属性存储系列中选中的项目。
访问函数：
| int | selectedItem() const |
| void | setSelectedItem(int index) |
通知信号：
| void | selectedItemChanged(int index) |
成员函数文档
[explicit] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
使用父对象parent 构建一个散点图3D系列。
[explicit] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
使用数据代理dataProxy 和父对象parent 构建一个散点图3D系列。
[virtual noexcept] QScatter3DSeries::~QScatter3DSeries()
删除散点图 3D 系列。
[static] int QScatter3DSeries::invalidSelectionIndex()
返回一个用于取消选中的无效索引。将该索引设置为selectedItem 属性，即可清除该系列中的选中项。
另请参阅 QAbstract3DGraph::clearSelection()。
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
将该序列的活动数据代理设置为proxy 。该序列会接管其上设置的任何代理，并在添加新代理时删除先前设置的代理。proxy 参数不能为空，也不能设置为另一个序列。
注意： 这是属性dataProxy 的设置 函数。
另请参阅 dataProxy()。
void QScatter3DSeries::setSelectedItem(int index)
选择序列数据数组中索引为index 的项。每次只能选择一个项。
要清除该系列的选择，需将invalidSelectionIndex() 设置为index 。如果该系列被添加到图表中，图表可根据用户交互或当选择失效时自动调整选择状态。在另一个已添加的系列上选择项目也会清除当前选择。
从该系列中移除项目或在所选项目之前插入项目时，系统会调整选中状态，以确保该项目保持选中。
注意： 这是属性 `selectedItem`的设置 函数。
另请参阅 selectedItem() 和QAbstract3DGraph::clearSelection()。
© 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.
