QScatter3DSeries 类
QScatter3DSeries 类表示 3D 散点图中的数据系列。 更多信息...
| 头文件 | #include <QScatter3DSeries> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| 实例化于 | Scatter3DSeries |
| 继承自 | QAbstract3DSeries |
| 状态 | 技术预览 |
- 所有成员列表，包括继承成员
- QScatter3DSeries 是 Qt 图形 C++ 3D 类 的一部分。
属性
- dataProxy : QScatterDataProxy*
- itemSize : float
- selectedItem : int
公共函数
| QScatter3DSeries(QObject *parent = nullptr) | |
| QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QScatter3DSeries() override |
| 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) |
静态公共成员
详细描述
此类管理系列特定的视觉元素，以及系列数据（通过数据代理）。
如果未为系列明确设置数据代理，系列将创建默认代理。设置另一个代理将销毁现有代理及其上添加的所有数据。
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 Graphs Data Handling with 3D。
属性文档
数据代理 : QScatterDataProxy*
此属性包含活动数据代理。
访问函数
| QScatterDataProxy * | 数据代理() const |
| void | setDataProxy(QScatterDataProxy *proxy) |
通知信号
| void | 数据代理已更改(QScatterDataProxy *proxy) |
项目大小 : float
系列的项目大小。
大小必须在 0.0f 和 1.0f 之间。将大小设置为 0.0f 将根据图中所有系列的总项目数自动缩放项目大小。
预设默认值为 0.0f。
访问函数
| float | 项目大小() const |
| void | setItemSize(float size) |
通知信号
| void | 项目大小已更改(float size) |
所选项目 : int
此属性包含系列中选定的项目。
访问函数
| int | 所选项目() const |
| void | setSelectedItem(int index) |
通知信号
| void | 所选项目已更改(int index) |
成员函数文档
[显式] QScatter3DSeries::QScatter3DSeries(QObject *parent = nullptr)
使用父项 parent 构造散点3D系列。
[显式] QScatter3DSeries::QScatter3DSeries(QScatterDataProxy *dataProxy, QObject *parent = nullptr)
使用数据代理 dataProxy 和父项 parent 构造散点3D系列。
[覆盖虚函数 noexcept] QScatter3DSeries::~QScatter3DSeries()
删除散点3D系列。
[静态] int QScatter3DSeries::invalidSelectionIndex()
返回用于选择的无效索引。此索引设置为 selectedItem 属性，以清除此系列的选择。
另请参阅 QAbstract3DGraph::clearSelection。
void QScatter3DSeries::setDataProxy(QScatterDataProxy *proxy)
将系列的活动数据代理设置为 proxy。系列假定对其设置的任何代理的所有权，并在添加新代理时删除先前设置的代理。proxy 参数不能为空或设置到另一个系列。
注意：此属性的设置函数为 dataProxy。
另请参阅 dataProxy。
void QScatter3DSeries::setSelectedItem(int index)
选择系列数据数组的索引index处的项。一次只能选择一个项。
如果要清除该系列的选中项，请将index设置为无效选择索引。如果此系列被添加到图中，图可以根据用户交互或选择项变为无效自动调整选择。在已添加的另一个系列上选择一个项也会清除选择。
在选择项之前从系列中删除项或插入项将调整选择，以便选择的项保持选中状态。
注意：属性selectedItem的设置函数。
另请参阅：selectedItem() 和 QAbstract3DGraph::clearSelection。
© 2024 Qt公司。本文档中的贡献属于各所有者的版权。所提供的文档根据自由软件基金会发布的GNU自由文档许可证第1.3版的条款进行许可。Qt及其相关标志是世界各地芬兰和/或其它国家的Qt公司的商标。所有其他商标均为其各自所有者的财产。
