xlsxwriter下载,xlsxwriter官方文档
本文介绍了XlsxWriter模块的几个常用类及其常用方法。
工作簿类定义:工作簿(文件名[,选项])
类创建XlsxWriter的工作簿对象。Workbook代表整个电子表格文件,存储在磁盘上。Filename为字符串类型,表示创建的excel文件的存储路径;
参数:
Options: dict类型,可选参数,一般用作初始化工作表内容的格式。
add _ worksheet add _ worksheet([sheet name])方法用于添加新工作表。Sheetname是工作表的名称,默认值是sheet1,例如:
工作表1=workbook . add _ worksheet()# sheet 1工作表2=workbook . add _ worksheet( test )# test工作表3=workbook . add _ worksheet( data )# data工作表4=workbook . add _ worksheet()# sheet 4
就相当于新增加的表格。
add _ format add _ format([properties])方法用于在工作表中创建新的format对象来设置单元格的格式。
参数:
Properties: dict type,这是一个指定格式属性的字典。
例如,按如下方式设置粗体格式对象:
bold=workbook . add _ format({ bold :true })等效语句如下:bold=workbook . add _ format()bold . set _ bold()add _ chart add _ chart(options)方法,用于在工作表中创建chart对象,由insert_chart()方法在内部实现。
例如,用线条设置一个图表对象,代码如下:
chart=workbook . add _ chart({ type : line })close close()方法,该方法用于关闭工作表文件,例如:
Workbook.close() Worksheet类表示一个excel工作表,这是一个核心类。工作表对象不能直接实例化,而是通过从Workbook对象调用add_worksheet()方法来创建。常见的方法如下:
Write write(row,col,*args args)方法:用于将普通数据写入单元格。
Row:行坐标;
Col:列坐标;
坐标索引起始值为0
*args:未命名的参数是数据内容,可以是数字、公式、字符串或格式对象。
为了简化不同数据类型的写入过程,write方法被用作其他更具体的数据类型方法的别名,例如:
Write.string():写字符串数据wirte_number():写数字数据write_blank():写空数据write_formula():写公式数据write_datetime():写日期数据wirte_boolean():写逻辑数据write_url():写超链接数据set _ rowset _ row (row,height,cell _ format,options)方法,用于设置行单元格的属性。
Row:指定行的位置,起始下标为0。
Height: float类型,以单位像素设置行高;
Cell _ format:格式类型,指定对象格式;
选项,字典类型,设置线隐藏,水平和折叠。
例子如下:
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 _ columns et _ column(first _ col,last _ col,width,cell _ format,options)方法,用于设置一列或多列单元格的属性。
First_col: integer,指定起始列位置,起始下标为0;
Last_col: integer,指定结束列位置,起始下标为0;
Width:float类型,设置列宽;
Cell _ format:格式类型,指定格式对象;
选项:字典类型,设置隐藏,水平和折叠;
例子如下:
工作表2.write (a1 , hello )工作表2.write (B1 , world )Bold=workbook . add _ format({ Bold :true })#将列A到B的单元格宽度设置为10像素,粗体工作表2.set _ column (0,1,10,bold) #将单元格C到D的宽度设置为20像素工作表2.set_column(C:D ,20)将单元格E到G隐藏到工作表2.set _ column (E: G ,none,{hidden: 1}
Row:行坐标,起始索引值为0;
Col:列坐标,起始索引值为0;
Image:string,是图像路径;
Options:dict type,可选参数,用于指定图片位置,如URL等信息;
例子如下:
#在B5单元格中插入python-logo.png的图片,以3358python.org工作表t1.insert _ image (B5 , img/python-logo.png ,{URL: 3358python.org})的超链接作为chart类的真实图表组件,包括面积图、条形图、条形图、折线图、散点图等。chart对象由Workbook的add_chart方法创建,图表类型由{type, chart type}字典确定。例子如下:
#创建柱形图chart=workbook.add _ chart ({type, column})。常见的图表样式如下:
面积:面积图样式
条形图:条形图
列:直方图
线条:线条样式的图表。
饼图:饼图
散布图:散布图
股票:股票型图表
雷达图:雷达样式的图表
然后通过工作表的insert_chart()方法将其插入到指定位置。示例如下:
#在单元格A7中插入图表worksheet.insert _ chart (A7 ,chart)的几种常用方法如下:
add _ series chart . add _ series(options)方法:用于添加一个数据系列的图表,参数options为字典类型,用于设置图表系列选项的字典。例子如下:
chart . add _ series({ categories :=sheet 1!$A$1:$A$5 , values: =Sheet1!$ b $1: $ b $5 , line: {color: red},add _ series的三个常用选项:
类别:设置图表类别的标签范围;
值:设置图表数据范围;
线条:设置图表线条属性,包括宽度、颜色等。
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 } })name:设置x轴的名称;
Name_font:设置X轴字体;
Num_font:设置X轴数字字体属性;
Set_size set_size(options)方法,用于设置图表大小。示例如下:
Chart.set _ size ({width: 720, height: 576}) width:设置宽度;
高度:设置高度;
Set_title set_title(options)方法设置图表的标题。示例如下:
chart . set _ title({ name : test })set _ styleset _ style(style _ id)方法,用于设置图表样式。style _ id是代表不同样式的不同数字。例子如下:
chart . set _ style(37)set _ table set _ table(options)方法,并将X轴设置为数据表格式。例子如下:
chart.set_table()