图表
下面是 Excelize 支持创建的图表类型 :
在 Office Excel 中图表数据区域 series
指定了绘制哪些数据的信息集合、图例项(系列)和水平(分类)轴标签。
下面是 Excelize 中 series
的可选参数:
参数 | 含义 |
---|---|
name | 图例项(系列),在图表图例和公式栏中显示。name 参数是可选的,如果不指定该值默认将会使用 Series 1 .. n 表示。name 支持使用公式表示,例如:Sheet1!$A$1 。 |
categories | 水平(分类)轴标签。在大多数图表类型中,categories 属性是可选的,默认为形如 1..n 的连续序列。 |
values | 图表数据区域,是 series 中最重要的参数,也是创建图表时唯一的必选参数。该选项将图表与其显示的工作表数据链接起来。 |
line | 设置折线图的折线格式。line 属性是可选的,如果未指定该属性,则为默认样式。可以设置的选项是 width ,宽度范围是 0.25pt 至 999pt。如果 width 的值超出范围,则线的默认宽度为 2pt。 |
marker | 设置折线图和散点图数据系列线型宽度和线端类型。可选参数 size 指定线型宽度,其取值范围是 2-72 (默认缺省值为 5 )。线端类型可选参数 symbol 的枚举值为 (默认缺省值为 auto ): circle , dash , diamond , dot , none , picture , plus , square , star , , x 和 auto . |
参数 legend
提供对图例项的属性设置方法,下面是 Excelize 中 legend
的可选参数:
参数 | 类型 | 含义 |
---|---|---|
none | bool | 指定是否关闭不与图表重叠的图例。默认值为 false |
position | string | 图例位置 |
show_legend_key | bool | 指定是否在数据标签中显示图例项标示 |
其中参数 position
默认值为 right
,该参数仅在当显示图例(即 none
的值为 false
)时生效。下面是该参数的可选值:
通过可选 title
对象的 name
参数设置图表标题,标题将会在图表上方显示。参数 name
支持使用公式表示,例如 Sheet1!$A$1
,图表标题的默认值为空。
参数 show_blanks_as
提供“隐藏和清空单元格”设置,默认值为:gap
即“空单元格显示为”:“空距”。下面是该参数的可选值:
值 | 含义 |
---|---|
gap | 空距 |
span | 用直线连接数据点 |
zero | 零值 |
通过参数 vary_colors
指定是否设置图表数据系列格式为自动填充颜色,默认值为 true
。
参数 format
提供对图表偏移、缩放、高宽比设置和打印属性等参数的设置,其参数与在 函数中所使用的相同。
通过可选 plotarea
对象设置数据标签格式,可选参数如下:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
show_bubble_size | bool | false | 气泡大小 |
show_cat_name | bool | true | 类别名称 |
show_leader_lines | bool | false | 显示引导线 |
show_percent | bool | false | 百分比 |
show_series_name | bool | 系列名称 | |
show_val | bool | false | 值 |
下面是 x_axis
参数的可选值:
下面是 y_axis
参数的可选值:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
none | bool | false | 隐藏坐标轴 |
major_grid_lines | bool | false | 主要网格线 |
minor_grid_lines | bool | false | 次要网格线 |
major_unit | float64 | 0 | 坐标轴主要刻度单位 |
reverse_order | bool | false | 逆序刻度值 |
maximum | int | 0 | 最大值,0 代表自动 |
minimum | int | 0 | 最小值,0 代表自动 |
通过可选 dimension
对象设置图表的大小,可选参数如下:
参数 | 类型 | 默认值 | 含义 |
---|---|---|---|
height | int | 290 | 高度 |
width | int | 480 | 宽度 |
参数 combo
用来指定创建组合图表,该图表将两个或多个图表类型组合在一个图表中。例如,在 区域创建一个 簇状柱形图 - 折线图:
根据给定的工作表名称和图表样式属性创建图表工作表,图表样式属性的定义与 函数相同。Excel 中的图表工作表是仅包含图表的工作表。