BarSeries QML Type
以条形图显示数据。更多
| Import Statement: | import QtGraphs |
| In C++: | QBarSeries |
| Inherits: |
- 所有成员的列表，包括继承成员
- BarSeries 是Qt Graphs QML Types for 2D 的一部分。
属性
- barDelegate : Component
- barSets : list<BarSet>
- barWidth : real
- barsType : enumeration
- borderColors : list<color>
- count : int
- labelsAngle : real
- labelsFormat : string
- labelsMargin : real
- labelsPosition : enumeration
- labelsPrecision : real
- labelsVisible : bool
- seriesColors : list<color>
信号
- barsetsAdded()
- barsetsRemoved()
- clicked(int index, BarSet barset)
- doubleClicked(int index, BarSet barset)
- pressed(int index, BarSet barset)
- released(int index, BarSet barset)
方法
- BarSet at(int index)
- Barset at(int index)
- clear()
- int find(BarSet barset)
- BarSet insert(int index, string label, VariantList values)
- bool remove(BarSet barset)
- bool remove(int index)
- removeMultiple(int index, int count)
- bool replace(list<BarSet> sets)
- bool replace(BarSet oldSet, BarSet newSet)
- bool replace(int index, BarSet barset)
详细说明
默认情况下，它将数据绘制为按类别分组的条形图系列，每个条形图组的每个类别都有一个条形图添加到系列中。它还支持水平条形图和堆叠分组条形图。
属性文档
barDelegate : Component |
自定义 QML 组件，用于可视化每个条形图。会为每个条形图创建该组件的实例。如果未定义该组件，则会使用默认的矩形可视化条形图。
该组件的动态属性如下
| 类型 | 名称 | 类型 名称 |
|---|---|---|
| 颜色 | 条形图颜色 | 条形图的填充颜色。该值来自GraphsTheme ，如果BarSet 覆盖了颜色，则来自BarSet::color 。 |
| 颜色 | 条形边框颜色 | 条形图的边框颜色。该值来自GraphsTheme 或BarSet::borderColor （如果BarSet 重载了该颜色）。 |
| 真实 | 条形边框宽度 | 条形图边框的宽度。该值来自GraphsTheme 或BarSet::borderWidth （如果BarSet 重载了宽度）。 |
| 实 | 条形值 | 条形图的值。该值来自BarSet::values 。 |
| 字符串 | barLabel | 条形图的标签。该值来自BarSet::label 。 |
| bool | barSelected | 当条形图被选中时，此值为 true，即条形图索引在BarSet::selectedBars 中。 |
| int | barIndex | 条形图的索引，从 0 到条形图的数量 - 1。 |
要使用这些属性，请在自定义组件中添加定义名称的属性。例如"property color barColor" 和"property real barValue" 。
barWidth : real |
宽度单位是 x 轴的单位。条形图的最小宽度为零，负值视为零。将宽度设置为零意味着无论 x 轴的比例如何，屏幕上条形图的宽度都是一个像素。宽度大于零的条形图将使用 x 轴的比例进行缩放。
默认情况下，barWidth 为 0.5（条形图的宽度为可用宽度的 50%）。有效值范围从 0.0（0%）到 1.0（100%）。
注意： 与BarSeries 类型一起使用时，该值指定的是一组条形图的宽度，而不是单个条形图的宽度。
barsType : enumeration |
条形图系列的类型：
| 常量 | 说明 |
|---|---|
BarSeries.BarsType.Groups | 条形图组按类别分组。这是默认值。 |
BarSeries.BarsType.Stacked | 条形图组按类别堆叠在一起。 |
BarSeries.BarsType.StackedPercent | 条形图组按类别堆叠在一起。分段大小与分段值占堆叠中所有分段总值的百分比相对应。 |
用于系列中所有对象的边框颜色列表。
如果系列数多于颜色数，颜色列表将重新打包，并从列表中的第一种颜色开始。如果未设置此项（默认），则将使用GraphsTheme::borderColors 中的颜色。
count : int |
条形图系列中的条形图组数。
labelsAngle : real |
数值标签的角度（单位：度）。
labelsFormat : string |
条形图系列中显示标签的格式。
另请参阅 QBarSeries::labelsFormat,labelsVisible, 和labelsPosition 。
labelsMargin : real |
数值标签的边距，单位为像素。
当labelsPosition 设置为LabelsPosition.Center 以外的值时，将使用边距。默认值为0 。
labelsPosition : enumeration |
数据值标签的位置：
| 常数 | 说明 |
|---|---|
BarSeries.LabelsPosition.Center | 标签位于条形图中心。 |
BarSeries.LabelsPosition.InsideEnd | 标签位于条形图内部顶部。 |
BarSeries.LabelsPosition.InsideBase | 标签位于底部条形图内部。 |
BarSeries.LabelsPosition.OutsideEnd | 标签位于顶部条形图外侧。 |
另请参阅 labelsVisible 和labelsFormat 。
labelsPrecision : real |
数值标签中显示的最大有效位数。
默认值为 6。
labelsVisible : bool |
条形图系列中标签的可见度。默认标签可见度为false 。
用于系列中所有对象的基色列表。
如果系列比颜色多，则颜色列表会从列表中的第一种颜色重新开始。如果未设置此项（默认），则将使用GraphsTheme::seriesColors 中的颜色。
信号文档
barsetsAdded() |
该信号在条形图组添加到系列时发出。
注： 相应的处理程序是onBarsetsAdded 。
barsetsRemoved() |
从系列中移除条形集时，将发出此信号。
注： 相应的处理程序是onBarsetsRemoved 。
当用户在barset 指定的条形图组中点击或点按index 指定的条形图时，将发出此信号。
注： 相应的处理程序是onClicked 。
当用户双击或轻按barset 指定的条形图集合中index 指定的条形图时，会发出该信号。该信号总是出现在clicked 之后。
注： 相应的处理程序是onDoubleClicked 。
当用户在barset 指定的条形图集合中点击或轻触index 指定的条形图，并按住鼠标按钮或手势时，将发出该信号。
注： 相应的处理程序是onPressed 。
当用户在barset 所指定的条形图集合中index 所指定的条形图上释放先前按下的鼠标按钮或手势时，将发出该信号。
注： 相应的处理程序是onReleased 。
方法文档
Barset at(int index) |
从系列中返回index 指定的条形集。否则返回null 。
clear() |
从系列中删除所有条形集。
将label 和values 添加到index 。values 可以是实数值列表或XYPoint 类型列表。
如果索引值等于或小于零，新的条形图集将被添加到条形图系列中。如果索引值等于或大于条形图系列中条形图集的数量，新的条形图集将追加到条形图系列中。
另请参阅 append()。
用 newSet 替换oldSet 指定的条形集。如果移除成功，则返回true ，否则返回false 。如果移除成功，则销毁oldSet 。
© 2025 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.
