实战PyQt5: 136-QChart图表之柱状图

柱形图，又称长条图、柱状统计图（英文：bar chart）亦称条图、条形图、条状图、棒形图等，是一种以长方形的长度为变量的统计图表。长条图用来比较两个或以上的价值（不同时间或者不同条件），只有一个变量，通常利用于较小的数据集分析。长条图亦可横向排列，或用多维方式表达。在QChart中，类QBarSeries, QBarSet处理柱状图的绘制。

QBarSeries

QBarSeries类将一系列数据显示为按类别分组的条形线。

QBarSet

QBarSet类代表条形图中的一组条形。条形图集为每个类别包含一个数据值。假定集合的第一个值属于第一类，第二个属于第二类，依此类推。如果该集合的值少于类别的值，则假定缺失值位于该集合的末尾。对于集合中间的缺失值，使用零值。

QBarSet常用函数：

• append(self, value)：追加新的值value。
• remove(self, index, count)：从index所指定的位置开始从条形集中删除count数量的值。。
• replace(self, index, value)：将index所指定的位置处的值替换为value。
• setBorderColor(self, color)：将条形的线条颜色设置为color。
• setBrush(self, brush)：设置条形的画刷为brush。
• setColor(self, color)：将条形的填充颜色设置为color。
• setLabel(self, label)：将条形的标签设置为label。
• setLabelBrush(self, brush)：设置标签使用的画刷为brush。
• setLabelColor(self, color)：设置标签的文本颜色为color。
• setLabelFont(self, font)：设置标签的文本字体为font。
• setPen(self, pen)：设置绘制条形边框线的画笔为pen。

QBarSet常用信号：

• borderColorChanged(self, color)：当条形图的线条（画笔）颜色更改为color时，将发出此信号。
• brushChanged(self)：当用于绘制条形组的画刷更改时，将发出此信号。
• clicked(self, index)：当用户单击栏组中由index指定的栏时，将发出此信号。
• colorChanged(self, color)：当条形图的填充（画刷）颜色变为color时，将发出此信号。
• doubleClicked(self, index)：当用户双击条形图中由index指定的条形时，将发出此信号。
• hovered(self, status, index)：当鼠标悬停在栏组中由index指定的栏上时，将发出此信号。当鼠标移到该栏上时，state将变为True，而当鼠标再次移开时，它将变为False。
• labelBrushChanged(self)：当用于绘制标签的笔刷更改时，将发出此信号。
• labelChanged(self)：条形组的标签更改时，将发出此信号。
• labelColorChanged(self, color)：当条形图的文本（标签）颜色变为color时，将发出此信号。
• labelFontChanged(self)：条形标签的字体更改时，将发出此信号。
• penChanged(self)：当用于绘制条形组的画笔改变时，将发出此信号。
• pressed(self, index)：当用户单击条形集中的index指定的条并按住鼠标按钮时，将发出此信号。
• released(self,index)：当用户在条形图中的index所指定的条上释放鼠标时，将发出此信号。
• valueChanged(self, index)：修改index指定位置的值时，将发出此信号。
• valuesAdded(self, index, count)：将新值添加到条形组时，将发出此信号。index指示第一个插入值的位置，count是插入值的数量。
• valuesRemoved(self, index, count)：从条形图中删除值时，将发出此信号。index指示第一个删除值的位置，count是删除值的数量。

柱状图演示

示例显示了如何创建条形图。并使用QBarCategoryAxis创建一个带 列表的轴来显示类别。然后添加到图表中，使用图表视图显示出来。完整代码如下:

import sys
from PyQt5.QtGui import QPainter, QPen
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow
from  PyQt5.QtChart import (QChartView, QChart, QBarSeries, QBarSet, 
                            QLegend, QBarCategoryAxis, QValueAxis)
 
class DemoChartBarSeries(QMainWindow):
    def __init__(self, parent=None):
        super(DemoChartBarSeries, self).__init__(parent)   
        
         # 设置窗口标题
        self.setWindowTitle('实战 Qt for Python: QChart柱状图演示')      
        # 设置窗口大小
        self.resize(480, 360)
        
        self.createChart()
        
    def createChart(self):
        
        #创建条状单元
        barSet0 = QBarSet('Jane')
        barSet1 = QBarSet('Jone')
        barSet2 = QBarSet('Axel')
        barSet3 = QBarSet('Mary')
        barSet4 = QBarSet('Samantha')
        
        barSet0.append([1, 2, 3, 4, 5, 6])
        barSet1.append([5, 0, 0, 4, 0, 7])
        barSet2.append([3, 5, 8, 13, 8, 5])
        barSet3.append([5, 6, 7, 3, 4, 5])
        barSet4.append([9, 7, 5, 3, 1, 2])
        
        #条状图
        barSeries = QBarSeries()
        barSeries.append(barSet0)
        barSeries.append(barSet1)
        barSeries.append(barSet2)
        barSeries.append(barSet3)
        barSeries.append(barSet4)
        
        #创建图表
        chart = QChart()
        chart.addSeries(barSeries)
        chart.setTitle('简单柱状图示例')
        chart.setAnimationOptions(QChart.SeriesAnimations) #设置成动画显示
        
        #设置横向坐标(X轴)
        categories = ['一月', '二月', '三月', '四月', '五月', '六月']
        axisX = QBarCategoryAxis()
        axisX.append(categories)
        chart.addAxis(axisX, Qt.AlignBottom)
        barSeries.attachAxis(axisX)
        
        #设置纵向坐标(Y轴)
        axisY = QValueAxis()
        axisY.setRange(0, 15)
        chart.addAxis(axisY, Qt.AlignLeft)
        barSeries.attachAxis(axisY)
        
        #图例属性
        chart.legend().setVisible(True)
        chart.legend().setAlignment(Qt.AlignBottom)
        
        #图表视图
        chartView = QChartView(chart)
        chartView.setRenderHint(QPainter.Antialiasing)
        
        self.setCentralWidget(chartView)
      
        
if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = DemoChartBarSeries()
    window.show()
    sys.exit(app.exec())   

运行结果如下图：

QChart柱状图演示

本文知识点

• 了解图表中的柱状图。
• 使用QBarSeries, QBarset绘制柱状图。
• 了解坐标轴QBarCategoryAxis。

前一篇: 实战PyQt5: 135-QChart图表之饼图