Python Excel操作模块XlsxWriter之添加图表 worksheet.insert_chart()

worksheet.insert_chart()

insert_chart(row, col, chart[, options])

向工作表单元格添加图表。

参数：

• row(int) - 单元格所在的行（索引从0开始计数）。
• col(int) - 单元格所在的列（索引从0开始计数）。
• chart - 图表对象。
• options(dict) - 可选的图表位置，缩放参数。

这个方法可用于向工作表插入图表。图表对象通过工作簿的add_chart()方法创建，其指定了图表类型：

chart = workbook.add_chart({type, 'column'})

然后将其作为嵌入图表插入到工作表中：

worksheet.insert_chart('B5', chart)

注意

一张图表只能被插入一张工作表一次。如果需要多张类似的图表，每一张必须通过add_chart()来单独创建。

insert_chart()方法接收字典形式的可选参数来定位和缩放图表。可用的参数和它们的默认值有：

{
    'x_offset': 0,
    'y_offset': 0,
    'x_scale':  1,
    'y_scale':  1,
}

偏移值是以像素为单位的：

worksheet.insert_chart('B5', chart, {'x_offset': 25, 'y_offset': 10})

x_scale和y_scale参数可以用来水平及垂直的缩放图表：

worksheet.insert_chart('B5', chart, {'x_scale': 0.5, 'y_scale': 0.5})

这些属性也可以通过set_size()方法设置。

注意

如果由于字体大于默认字体大小货打开了文本换行，图表的缩放可能会受到影响，因为它的默认高度已经更改。如果它与插入的图表交叉，你应该使用set_row()显式地设置行高来避免此问题，。