python学习-xlsxwriter模

Xlsx是python用来构造xlsx文件的模块，可以向excel2007+中写text，numbers，formulas 公式以及hyperlinks超链接。

可以完成xlsx文件的自动化构造，包括：

合并单元格，制作excel图表等功能：

import xlsxwriter


# Create an new Excel file and add a worksheet.  
workbook = xlsxwriter.Workbook('demo.xlsx')     #创建工作簿
worksheet = workbook.add_worksheet()            #创建工作表

# Widen the first column to make the text clearer. 
worksheet.set_column('A:A', 20)       #设置一列或者多列单元属性

# Add a bold format to use to highlight cells.
bold = workbook.add_format({'bold': True})    #在工作表中创建一个新的格式对象来格式化单元格，实现加粗

# Write some simple text.
worksheet.write('A1', 'Hello')       #工总表写入简单文本

# Text with formatting.
worksheet.write('A2', 'World', bold)     #工作表写入带有格式的文本，加粗

# Write some numbers, with row/column notation.  #按照坐标写入
worksheet.write(2, 0, 123)     
worksheet.write(3, 0, 123.456)

# Insert an image.
worksheet.insert_image('B5', 'logo.png')   #插入图片

workbook.close()    #关闭工作薄

方法详细解释：

1.workbook类

定义：Workbook(filename[,options])

该类创建一个XlsxWriter的Workbook对象。Workbook代表整个电子表格文件，并且存储在磁盘上。filename为字符串类型，表示创建的excel文件存储路径；

options：为dict类型，是可选参数，一般作为初始化工作表内容格式

add_worksheet

add_worksheet([sheetname])方法，用于添加一个新的工作表，sheetname为工作表名称，默认是sheet1，例如：

    worksheet1 = workbook.add_worksheet()   #sheet1
    worksheet2 = workbook.add_worksheet('test')     #test
    worksheet3 = workbook.add_worksheet('data')     #data
    worksheet4 = workbook.add_worksheet()   #sheet4

add_format

add_format([properties])方法，用于在工作表中创建一个新的格式对象来格式化单元格

properties：为dict类型，为指定一个格式属性的字典

例如设置一个加粗的格式对象如下：

    bold = workbook.add_format({'bold': True})
    等价的语句如下：
    bold = workbook.add_format()
    bold.set_bold()

add_chart

add_chart(options)方法，用于在工作表中创建一个图表对象，内部是通过insert_chart()方法来实现的，参数为dict类型，是为图标指定一个字典属性。

例如设置一个线条行的图表对象，代码如下：

  chart = workbook.add_chart({'type': 'line'})1

close

close()方法，作用是关闭工作表文件，如：

workbook.close()

2.Worksheet类

代表一个excel工作表，是比较核心的一个类。Worksheet对象不能直接实例化，而是通过Workbook对象调用add_worksheet()方法来创建，常见的方法如下：

write

write(row, col, *args)方法：是用来将普通数据写入单元格中。

row：行坐标；
col：列坐标； 坐标索引起始值为0
*args：无名字参数为数据内容，可为数字，公式，字符串或格式对象

为了简化不同数据类型的写入过程，write方法已作为其他更加具体的数据类型方法的别名，如：

  write.string()：写入字符串类型数据 
  wirte_number()：写入数字型数据 
  write_blank()：写入空类型数据  
 write_formula()：写入公式型数据 
 write_datetime()：写入日期型数据  
 wirte_boolean()：写入逻辑型数据  
 write_url()：写入超链接型数据

set_row

set_row(row, height, cell_format, options)方法，用于设定行单元格的属性。

row：指定行位置，起始下标为0；
height：为float类型，设定行高，单位像素；
cell_format：format类型，指定对象格式；
options，字典类型，设置行hidden（隐藏）、level（组合分级）、collpsed（折叠）

示例如下：

  worksheet2.write('A1', 'hello')
  bold = workbook.add_format({'bold': True})  # 设定A1行高40，加粗
  worksheet2.set_row(0, 40, bold)  # 隐藏第二行
  worksheet2.set_row(1, None, None, {'hidden': True})

set_column

set_column(first_col, last_col, width, cell_format, options)方法，用于设置一列或多列单元格的属性

first_col：整型，指定开始列位置，起始下标为0；
last_col：整型，指定结束列位置，起始下标为0；
width：float类型，设置列宽；
cell_format：format类型，指定格式对象；
options：dict类型，设置hidden（隐藏）、level（组合分级）、collpsed（折叠）；

示例如下：

  worksheet2.write('A1', 'hello')
  worksheet2.write('B1', 'world')
  bold = workbook.add_format({'bold': True})  # 设定列A到B单元格宽度10像素，加粗
  worksheet2.set_column(0, 1, 10, bold)  # 设置C到D单元格宽度20像素
  worksheet2.set_column('C:D', 20)
  隐藏E到G单元格
  worksheet2.set_column('E:G', None, None, {'hidden': 1})

insert_image

insert_image(row, col, image[, options])方法，用于插入图片到指定的单元格，支持PNG，JPEG，BMP等多种格式。

row：行坐标，起始索引值为0；
col：列坐标，起始索引值为0；
image：string类型，是图片路径；
options：dict类型，是可选参数，用于指定图片位置，如URL等信息；

示例如下：

  # 在B5单元格插入python-logo.png图片，超链接为http://python.org
  worksheet1.insert_image('B5', 'img/python-logo.png', {'url': 'http://python.org'})12

chart类实图表组件，支持包括面积、条形图、柱状图、折线图、散点图等，一个图表对象是通过Workbook的add_chart方法创建，通过{type, ‘图表类型’}字典来制定图表类型，示例如下：

  # 创建一个column（柱形）图表
  chart = workbook.add_chart({type, 'column'})12

常见的图表样式如下：

area：面积样式的图表
bar：条形图
column：柱状图
line：线条样式的图表
pie：饼形图
scatter：散点图
stock：股票样式的图表
radar：雷达样式的图表

然后通过Worksheet的insert_chart()方法插入到指定位置，示例如下：

几个常用方法如下：

add_series

chart.add_series(options)方法：用于添加一个数据系列的图表，参数options为字典类型，用于设置图表系列选项的字典，示例如下：

  chart.add_series({
      'categories': '=Sheet1!$A$1:$A$5',
      'values': '=Sheet1!$B$1:$B$5',
      'line': {'color': 'red'},
  })12345

add_series的常用三个选项：

categories：设置图表类别标签范围；
values：设置图表数据范围；
line：设置图表线条属性，包括宽度、颜色等；

set_x_axis

set_x_axis(options)方法，设置图表X轴选项，示例如下：

 chart.set_x_axis({      'name': 'x name',      'name_font': {'size': 14, 'bold': True}      'num_font': {'italic': True}
  })12345
  
  name：设置x轴名称；
name_font：设置x轴字体；
num_font：设置x轴数字字体属性；

set_size

set_size(options)方法，用于设置图表大小，示例如下：

  chart.set_size({'width': 720, 'height': 576})1

width：设置宽度；
height：设置高度；

set_title

set_title(options)方法，设置图表标题，示例如下：

chart.set_title({'name': 'test'})1

set_style

set_style(style_id)方法，用于设置图表样式，style_id为不同数字代表不同样式，示例如下：

  chart.set_style(37)1

set_table

set_table(options)方法，设置x轴为数据表格式。示例如下：

  chart.set_table()