QBar3DSeries Class
QBar3DSeries 类表示 3D 条形图中的数据系列。更多内容...
| 头文件： | #include <QBar3DSeries> |
| CMake： | find_package(Qt6 REQUIRED COMPONENTS DataVisualization) target_link_libraries(mytarget PRIVATE Qt6::DataVisualization) |
| qmake： | QT += datavisualization |
| 自： | QtDataVisualization 1.0 |
| 在 QML 中： | Bar3DSeries |
| 继承自： | QAbstract3DSeries |
| 状态： | 已弃用 |
该类已弃用。我们强烈建议不要在新代码中使用它。
属性
- dataProxy : QBarDataProxy*
- meshAngle : float
(since 6.3)rowColors : QList<QColor>- selectedBar : QPoint
公共函数
| QBar3DSeries(QObject *parent = nullptr) | |
| QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr) | |
| virtual | ~QBar3DSeries() |
| 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 Data Visualization 数据处理和QAbstract3DGraph::locale 。
属性文档
dataProxy : QBarDataProxy*
该属性保存活动数据代理。
该系列会接管其上设置的任何代理，并在添加新代理时删除先前设置的代理。代理不能为空，也不能设置为另一个系列。
访问函数：
| 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 。
[since 6.3] rowColors : QList<QColor>
该属性存储了该系列中行颜色的列表。
该属性可用于将系列中的行设置为不同的颜色。若要使用此属性，必须将Q3DTheme::ColorStyle 设置为Q3DTheme::ColorStyleUniform 。
该枚举类型在 Qt 6.3 中引入。
访问函数：
| QList<QColor> | rowColors() const |
| void | setRowColors(const QList<QColor> &colors) |
通知信号：
| void | rowColorsChanged(const QList<QColor> &rowcolors) |
另请参阅 Q3DTheme::ColorStyleUniform 。
selectedBar : QPoint
该属性保存所选系列中的条形。
访问函数：
| QPoint | selectedBar() const |
| void | setSelectedBar(const QPoint &position) |
通知信号：
| void | selectedBarChanged(const QPoint &position) |
成员函数文档
[explicit] QBar3DSeries::QBar3DSeries(QObject *parent = nullptr)
使用父类parent 构建一个“bar 3D”系列。
[explicit] QBar3DSeries::QBar3DSeries(QBarDataProxy *dataProxy, QObject *parent = nullptr)
使用数据代理dataProxy 和父对象parent 构建一个条形图3D系列。
[virtual noexcept] QBar3DSeries::~QBar3DSeries()
删除一个条形3D数据系列。
[static] QPoint QBar3DSeries::invalidSelectionPosition()
返回一个无效的选择位置。该位置将被设置为selectedBar 属性，以清除该系列中的选择。
另请参阅 QAbstract3DGraph::clearSelection()。
void QBar3DSeries::setSelectedBar(const QPoint &position)
选择位于position 位置的柱形，该位置由系列数据数组中的行和列指定。
每次只能选择一个柱形。
要清除该系列中的选择，需将invalidSelectionPosition() 设置为position 。
如果该系列被添加到图表中，图表会根据用户交互或当选择失效时调整选择范围。选择另一个已添加系列中的条形也会清除当前选择。
从该系列中删除或插入位于所选柱形行之前的行，将调整选中状态，以便保持同一根柱形被选中。
注意： 这是属性selectedBar 的设置 函数。
另请参阅 selectedBar() 和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.
