图表及其序列

设置图表的类型

使用chart对象的chart_type属性或Chart对象的ChartType属性设置图表的类型。对于图表对象cht，设置图表类型如下所示：

【xlwings】

>>> cht.chart_type="column_clustered"

【xlwings API】

>>> cht.ChartType=xw.constants.ChartType.xlColumnClustered

chart_type或ChartType属性的取值如表5-1所示。表中第3列中表示图表类型的字符串作为xlwings使用方式下chart_type属性的取值，前两列的常数或值作为API使用方式下ChartType属性的取值。值可以直接写，常数的形式类似xw.constants.ChartType.xlLine。

表5-1 Excel的图表类型

利用5.1节提供的数据，下面用Shapes对象的AddChart2方法创建更多类型的图表。

>>> sht.api.Range("A1").CurrentRegion.Select()  #数据
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlColumnClustered,20,150,300,200,True)
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlBarClustered,400,150,300,200,True)
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlConeBarStacked,20,400,300,200,True)
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlLineMarkersStacked,400,400,300,200,True)
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlXYScatter,20,650,300,200,True)
>>> sht.api.Shapes.AddChart2(-1,xw.constants.ChartType.xlPieOfPie,400,650,300,200,True)

生成不同类型的图表如图5-4所示。

图5-4 创建不同类型的图表

Chart对象的常用属性和方法

前一小节我们用Chart对象的ChartType属性设置了图表的类型，实际上，Chart对象还有很多其他属性和方法，使用它们可以对图表进行各种设置。Chart对象常见的属性和方法如表5-2所示。这些属性和方法的用法在后面会陆续进行介绍。

表5-2 Chart对象的常用属性

设置序列

每个Chart对象都有一个SeriesCollection属性，它返回一个包含图表中所有序列的集合。那什么是序列呢？对于图5-1中生成的复合柱状图，每个省市对应一个复合柱形，每个复合柱形中有六个不同颜色的单一柱形，这里面，所有省市相同颜色的单一柱形一起组成一个序列。所以，图中一共有六个序列。用Series对象表示序列。

下面利用图5-5中给定的数据，用Shapes对象绘制图表。

>>> sht.api.Range("A1:B7").Select()
>>> cht=sht.api.Shapes.AddChart().Chart

生成的图表如图5-5中所示。程序中第一行选择绘图数据，第二行使用Shapes对象的AddChart方法创建表示图表的Shape对象，用该对象的Chart属性返回一个Chart对象。

图5-5 默认时生成的图表

Chart对象的SeriesCollection属性返回包含图表中所有序列的集合。下面使用Count属性获取集合中序列的个数。

>>> cht.SeriesCollection().Count
2

图5-5中共有两种不同颜色的柱形，每种颜色的柱形构成一个序列，所以一共有两个序列。

使用序列的名称或序列在集合中的索引号可以引用序列。下面引用第2个序列，用它的 ChartType属性将图形类型改变为折线图。设置Smooth属性的值为True，对折线进行平滑处理。用MarkerStyle属性将各数据点处的标记设置为三角形，用MarkerForegroundColor属性将标记的颜色设置为兰色。设置HasDataLabel属性的值为True，显示数据标签。

>>> ser2=cht.SeriesCollection("P2")  #第2个序列
>>> ser2.ChartType=xw.constants.ChartType.xlLine  #线形图
>>> ser2.Smooth=True  #平滑处理
>>> ser2.MarkerStyle=xw.constants.MarkerStyle.xlMarkerStyleTriangle  #标记
>>> ser2.MarkerForegroundColor=xw.utils.rgb_to_int((0,0,255))  #颜色
>>> ser2.HasDataLabels=True  #数据标签

现在图表变成图5-6所示的样子。可见，通过设置图表中Series对象的属性，可以对单个序列进行改变。

图5-6 改变序列的属性值

设置序列中单个点的属性

使用Series对象的Points属性，可以获取序列中的全部数据点。通过索引，可以把其中的某个或某些点提取出来进行设置。单个的点用Point对象表示，利用该对象的属性和方法，可以对指定的点进行设置。点的设置主要用于折线图、散点图和雷达图等。

接着5.2.3小节的例子，获取第2个序列中数据点的数量。

>>> Num=ser2.Points().Count
>>> Num
6

Point对象的常用属性如表5-3中所示。

表5-3 Point对象的常用属性

Point对象的MarkerStyle属性设置标记的样式。该属性的值为XlMarkerStyle枚举类型的值，如表5-4中所示。

表5-4 Point对象的MarkerStyle属性取值

下面在表示序列2的折线图中改变第3个点的属性。设置它的前景色和背景色为兰色，设置标记样式为菱形，设置标记大小为10。

>>> ser2.Points(3).MarkerForegroundColor=xw.utils.rgb_to_int((0,0,255))
>>> ser2.Points(3).MarkerBackgroundColor=xw.utils.rgb_to_int((0,0,255))
>>> ser2.Points(3).MarkerStyle=xw.constants.MarkerStyle.xlMarkerStyleDiamond
>>> ser2.Points(3).MarkerSize=10

设置效果如图5-7所示。设置以后，序列中第3个点进行了突出显示。

图5-7 设置第3个点的属性值