本页内容

BarSet QML Type

表示条形图中的一组条形。更多...

Import Statement: import QtCharts 2.12
In C++: QBarSet
Status: Deprecated

此类型已弃用。我们强烈建议不要在新代码中使用它。

属性

信号

方法

  • void append(real value)
  • real at(int index)
  • void remove(int index, int count)
  • void replace(int index, real value)

详细说明

一个条形图数据集包含每个类别的一个数据值。数据集中的第一个值被假定属于第一个类别,第二个值属于第二个类别,依此类推。如果数据集中的值少于类别数,则缺失的值被假定位于数据集的末尾。 对于位于集合中间的缺失值,将使用数值零。零值集合的标签不予显示。

另请参阅 AbstractBarSeries 、BarSeries 、StackedBarSeries 、PercentBarSeries 、HorizontalBarSeries 、HorizontalStackedBarSeries 以及HorizontalPercentBarSeries 。

属性文档

borderColor : color

条形图集的线条(笔触)颜色。

borderWidth : real

边框线的宽度。默认宽度为 2.0。

brushFilename : string

该画笔组中用作画笔的文件名称。

color : color

该条形图组的填充(笔触)颜色。

count : int

条形图集合中的数据点数量。

label : string

酒吧套装的标签。

labelColor : color

该条形图集的文本(标签)颜色。

labelFont : font

用于绘制条形图集标签的字体。

有关更多信息,请参阅font 。

values : list<var>

条形集的值。您可以将real 或point 类型的列表作为值进行设置。

若将实数类型的列表作为值设置,这些数值将直接定义条形集的数值。

如果将点类型的列表作为值设置,则该点的 x 坐标即指定其在条形集中的以零为起点的索引。 条形集的大小等于最大的 x 坐标值 + 1。如果 0 到最大值之间的任何 x 坐标处缺少一个点,则该点将取值为 0。

例如,以下柱形图集的数值相同:

myBarSet1.values = [5, 0, 1, 5];
myBarSet2.values = [Qt.point(0, 5), Qt.point(2, 1), Qt.point(3, 5)];

信号文档

clicked(int index)

当用户点击条形图集中由 `index ` 指定的条形时,会触发此信号。

相应的信号处理程序是onClicked 。

注意: 相应的处理程序 为onClicked 。

doubleClicked(int index)

当用户在条形图集中双击由 `index ` 指定的条形时,会触发此信号。

相应的信号处理程序是onDoubleClicked 。

注意: 相应的处理程序 是onDoubleClicked 。

pressed(int index)

当用户点击条形图集(bar set)中由index 指定的条形,并按住鼠标按钮时,会触发此信号。

相应的信号处理程序是onPressed 。

注意: 相应的处理程序 为onPressed 。

released(int index)

当用户在条形图集中松开index 指定的条形上的鼠标按钮时,会触发此信号。

相应的信号处理程序是onReleased 。

注意: 相应的处理程序 是onReleased 。

valueChanged(int index)

当index 指定的位置处的值发生更改时,会触发此信号。

相应的信号处理程序是onValueChanged 。

注意: 相应的处理程序 是onValueChanged 。

valuesAdded(int index, int count)

当向条形数据集添加新值时,会触发此信号。index 表示第一个插入值的位置,count 表示插入的值个数。

相应的信号处理程序为onValuesAdded 。

注意: 相应的处理程序 是onValuesAdded 。

valuesRemoved(int index, int count)

当从条形数据集移除值时,会触发此信号。index 表示首个被移除值的位置,count 表示被移除值的个数。

相应的信号处理程序为onValuesRemoved 。

注意: 相应的处理程序 是onValuesRemoved 。

方法文档

void append(real value)

将value 指定的新值追加到条形集的末尾。

real at(int index)

从条形图集中返回由index 指定的值。如果索引超出范围,则返回0.0。

void remove(int index, int count)

从以index 指定的值开头的条形集合中,移除count 指定的数量的值。

如果省略count ,则仅移除由index 指定的值。

void replace(int index, real value)

将value 指定的值添加到位于index 指定位置的条形上。

© 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.