QBar3DSeries 类
QBar3DSeries 类表示 3D 条形图中的数据系列。 更多...
| 头文件 | #include <QBar3DSeries> |
| CMake | find_package(Qt6 REQUIRED COMPONENTS Graphs) target_link_libraries(mytarget PRIVATE Qt6::Graphs) |
| qmake | QT += graphs |
| 实例化 | Bar3DSeries |
| 继承 | QAbstract3DSeries |
| 状态 | 技术预览 |
- 所有成员列表，包括继承成员
- QBar3DSeries 是 Qt Graphs C++ 3D 类 的一部分。
属性
- dataProxy : QBarDataProxy*
- meshAngle : float
- rowColors : QList<QColor>
- selectedBar : QPoint
公有函数
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() override |
| QBarDataProxy * | dataProxy() const |
| float | meshAngle() const |
| QList<QColor> | rowColors() const |
| QPoint | selectedBar() const |
| void | setDataProxy(QBarDataProxy *proxy) |
| void | setMeshAngle(float angle) |
| void | setRowColors(const QList<QColor> &colors) |
| void | setSelectedBar(const QPoint &position) |
信号
| void | dataProxyChanged(QBarDataProxy *proxy) |
| void | meshAngleChanged(float angle) |
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
| void | selectedBarChanged(const QPoint &position) |
静态公有成员
| QPoint | invalidSelectionPosition() |
详细描述
此类管理系列特定的视觉元素以及系列数据（通过数据代理）。
如果未为系列明确设置数据代理，则系列将创建默认代理。设置另一个代理将销毁现有代理及其上添加的所有数据。
QBar3DSeries 支持以下格式标记用于 QAbstract3DSeries::setItemLabelFormat()
| @rowTitle | 来自行轴的标题 |
| @colTitle | 来自列轴的标题 |
| @valueTitle | 来自值轴的标题 |
| @rowIdx | 可见行索引。使用图表区域进行本地化。 |
| @colIdx | 可见列索引。使用图表区域进行本地化。 |
| @rowLabel | 来自行轴的标签 |
| @colLabel | 来自列轴的标签 |
| @valueLabel | 使用附加到图表的价值轴的格式格式化项目值。有关更多信息，请参阅QValue3DAxis::labelFormat。 |
| @seriesName | 系列名称 |
| %<格式规范> | 在指定格式中格式化的项目值。使用与QValue3DAxis::labelFormat相同的规则格式化。 |
例如
proxy->setItemLabelFormat(QStringLiteral("@valueTitle for (@rowLabel, @colLabel): %.1f"));
另请参阅Qt Graphs 3D数据处理和QAbstract3DGraph::locale。
属性文档
dataProxy : QBarDataProxy*
此属性包含活动数据代理。
系列假定它对任何设置为它的代理拥有所有权，并在添加新代理时删除先前设置的代理。代理不能为null或设置为另一个系列。
访问函数
| QBarDataProxy * | dataProxy() const |
| void | setDataProxy(QBarDataProxy *proxy) |
通知信号
| void | dataProxyChanged(QBarDataProxy *proxy) |
meshAngle : float
此属性包含系列旋转角度（以度为单位）。
设置此属性等同于以下调用
setMeshRotation(QQuaternion::fromAxisAndAngle(0.0f, 1.0f, 0.0f, angle))
注意：当读取此属性时，它使用浮点精度从QAbstract3DSeries::meshRotation值计算，并且始终返回0到360度之间的值。
访问函数
| float | meshAngle() const |
| void | setMeshAngle(float angle) |
通知信号
| void | meshAngleChanged(float angle) |
另请参阅QAbstract3DSeries::meshRotation。
rowColors : QList<QColor>
此属性包含系列中的行列颜色列表。
此属性可用于使用不同的颜色为系列的行着色。必须将Q3DTheme::ColorStyle设置为Q3DTheme::ColorStyle::Uniform才能使用此属性。
访问函数
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
通知信号
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
另请参阅Q3DTheme::ColorStyle::Uniform。
selectedBar : QPoint
此属性包含被选中的系列中的条形。
访问函数
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
通知信号
| void | selectedBarChanged(const QPoint &position) |
成员函数文档
[显式] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
使用父对象parent构造一个柱状3D系列。
[显式] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
使用数据代理dataProxy和父parent构造一个柱状3D系列。
[覆盖虚函数 noexcept] QBar3DSeries::~QBar3DSeries()
删除一个3D条形系列。
[静态] QPoint QBar3DSeries::invalidSelectionPosition()
返回一个无效的选取位置。此位置被设置为 selectedBar 属性，以从系列中清除选择。
另请参阅QAbstract3DGraph::clearSelection().
void QBar3DSeries::setSelectedBar(const QPoint &position)
选择指定为系列数据数组中的行和列的 position 位置的条形。
一次只能选择一个条形。
要从系列中清除选择，请将 invalidSelectionPosition() 设置为 position。
如果系列被添加到图表中，图表可以根据用户交互或如果变得无效来调整选择。选择另一个添加的系列上的条形也会清除选择。
在选定的条形的行之前从系列中移除行或将行插入到系列中，将调整选择，以便保持相同的条形被选中。
注意：属性 selectedBar 的设置器函数。
另请参阅selectedBar() 和 QAbstract3DGraph::clearSelection().
© 2024 The Qt Company Ltd. 本文档中的贡献是基于各自所有者的版权。本提供的文档是根据自由软件基金会发布的 GNU自由文档许可证1.3版本 许可的。Qt及其相关标志是The Qt Company Ltd在芬兰和/或世界其他国家的商标。所有其他商标均为其各自所有者的财产。
