在上篇文章《操作Excel的Xlwings教程(二)》中重点介绍了Xlwings中的App,Book等API知识点。本次推文将继续上次的知识点,将继续介绍Xlwings中Sheet和Range等API相关的知识,并展示一些小例子,让大家可以跟着教程进行学习。
顺便说一下,本人使用的Xlwings的版本号为:0.19.1
Xlwings中的Sheet对应的是Excel文件中的Sheet页,Range对应的是Excel文件的单元格,在Xlwings中Range在有些时候也表示一个选定的区域。当然在选定Range之前,我们是需要进行Sheet页的引用的。
一、 Sheets
跟Apps和App的关系一样,所有的Sheet构成Sheets集合。假设现在我们有一个Excel文件1.xlsx,它有两个Sheet页Shee1和Shee2,我们尝试进行以下的操作:
import xlwings as xwwb = xw.Book('1.xlsx') #以xw.Book()方式打开工作簿print(wb.sheets) #查看当前工作簿的所有Sheet详情print(wb.sheets.active) #激活一个Sheet发现是Sheet2# 在Sheet1前新增一个Sheet并命名print(wb.sheets.add(name='Python知识学堂', before='Sheet1'))# print(wb.sheets.add(name='Python知识学堂', 1)) print(wb.sheets.active) #激活Sheet页,这个Sheet是新增的
以上代码中的输出如下:
Sheets([<Sheet [1.xlsx]Sheet1>, <Sheet[1.xlsx]Sheet2>])
<Sheet [1.xlsx]Sheet2>
<Sheet [1.xlsx]Python知识学堂>
<Sheet [1.xlsx]Python知识学堂>
且打开的1.xlsx文件的Sheet页的详情如下截图:
所以我们总结出其中的两个操作:
# 返回激活(活动)工作表wb.sheets.active# 新增Sheet页,参数默认均为None,其中name为名称,before指在那个页签前插入,after为哪个页签之后插入。wb.sheets.add(name= None,before = None,after = None)
二、 Sheet
之前提及到所有的Sheet构成Sheets集合,这一小节我们将介绍属于Sheet(或)Sheets的一些常用方法或属性(操作)。
假设现在我们有一个Excel文件2.xlsx,它有两个Sheet页Shee1和Shee2,我们尝试进行以下的操作:
import xlwings as xwwb = xw.Book('2.xlsx')wb.sheets[0]) # 使用索引值引用"2.xlsx"文件的Sheet1wb.sheets['Sheet1'] # 直接使用名称引用"2.xlsx"文件的Sheet1wb.sheets.add() # 新建一个Sheet。默认为Sheet3wb.sheets.count # 获得工作簿中工作表sheet的数量
方法或属性:
sheet = wb.sheets['Sheet1'] # 引用工作表Sheet1sheet.active #获取当前活跃的工作簿sheet.autofit() #在整个工作表上自动调整宽度,可传参数sheet.autofit(axis='c') # 在整个工作表上自动调整列的宽度sheet.autofit(axis='r') # 在整个工作表上自动调整行的宽度sheet.book # 返回指定Sheet的book,输出 <Book [2.xlsx]>sheet.cells # 返回一个Range对象,该对象表示Sheet上的所有单元格(而不仅仅是当前正在使用的单元格)输出<Range [2.xlsx]Sheet1!$1:$1048576>sheet.name # 获取工作表的名称sheet.name = '我爱python知识学堂'# 工作表重命名sheet.clear() # 清空工作表中的内容和格式sheet.index # 返回对应sheet的索引值,从0计数sheet.delete() # 删除工作表sheet.clear_contents() # 清除工作表的内容,但保留格式# 工作表sheet中有数据区域最大的行数,法1sheet['a1048576'].end('up').row # 工作表sheet中有数据区域最大的行数,法2sheet.used_range.last_cell.row# 工作表sheet中有数据区域最大的列数,法1sheet['xfd1'].end('left').column# 工作表sheet中有数据区域最大的列数,法2 sheet.used_range.last_cell.column # 返回工作表中已经使用的单元格区域 sheet.api.UsedRange 或sheet.used_range sheet.api.row('2:4').insert # 插入行,在第2-4行插入空白行sheet.api.row('2:4').delete # 删除行# 取值sheet.cells(行号,列号).value
三、Range
在Excel中我们做的最多的就是对Excel单元格的操作,在Xlwings中涉及到的Range的方法也是比较多的。这一章我们将使用小例子的方式探究Xlwings中涉及到的有关Range的方法或属性。
假设我们有一个名为“3.xlsx”的文件,其数据如下:
先导入模块,并打开工作簿,引用sheet1工作表:
import xlwings as xwapp = xw.App(visible=True,add_book=False)wb = app.books.open('3.xlsx')sheet = wb.sheets['Sheet1'] # 或wb.sheets[0]wb.close()app.quit()app.kill()
正如之前讲述的,上述代码是创建应用打开Excel的,这种方式打开之后需要进行关闭。
以下我们使用Xlwings中的Book
import xlwings as xwwb = xw.Book('3.xlsx')# sheet = wb.sheets[0]# 这里我们直接引用“当前活动工作表的单元格”Range = xw.Range('A1')
方法或属性:
xw.Range('A1') # 引用A1单元格xw.Range('A1').value # 取A1单元格的值,输出1.0xw.Range('A1').value = 12 # 设置值xw.Range('A1').raw_value # 直接获取并设置所使用(pywin32)引擎发送/接受的值,而无需进行任何xlwings数据清理/转换。xw.Range ('A1:B2').value # 引用区域并取值,输出[[1.0, 9.0],[2.0, 10.0]],以二元list形式# 与上述等效xw.Range ((1,1), (2,2)).value # 与上述等效xw.Range (('A1'), ('B2')).value # 添加超链接xw.Range ('A9').add_hyperlink(address='www.baidu.com') xw.Range ('A10').address # 返回表示范围参考的字符串值,输出 $A$10xw.Range ('A1').api # 返回所使用引擎的本机对象xw.Range ('A1').autofit() # 自动调整范围内所有单元格的宽度和高度。# 如果仅自动调整列的宽度,使用sheet.range('A1:B2').columns.autofit()# 如果仅自动调整行的高度,使用 sheet.range('A1:B2').rows.autofit()xw.Range ('A1').clear() # 清除所选择单元格的内容和格式,可选择范围# 清除范围的内容,但保留格式。xw.Range ('A1').clear_contents() xw.Range ('A1').color #获取A1单元格的背景色。#设置A1单元格的背景色,RGB颜色xw.Range ('A1').color = (255,255,255) xw.Range ('A1').color = None #删除背景色xw.Range ('B1:C4').column # 返回所选范围第一列的列标,此处输出2xw.Range ('B2:C4').row # 返回所选范围第一行的行标,此处输出2xw.Range ('A1:B2').count # 返回所选范围单元格数量,此处输出4# 此属性返回一个Range对象,该对象表示由(但不包括)空白行和空白列或工作表的边缘的任意组合限制的范围,好比是一片连接的区域xw.Range ('A1').current_region xw.Range ('A1').delete() # 删除单元格A1,有参数left和up,如delete('up')。如果省略,Excel将根据范围的形状进行决定。xw.Range ('A1').end('down') # 返回一个Range对象,该对象表示包含源范围的区域末尾的单元格。此处输出<Range [3.xlsx]Sheet1!$A$8>,参数可传down,up,left,right,其实也是返回ctrl + 方向# 设置A9单元格公式计算的值xw.Range ('A9').formula='=SUM(B1:B5)'# 输出公式值,输出'=SUM(B1:B5)'print(xw.Range ('A9').formula) # 以指定的格式返回范围的地址xw.Range ('A1:B2').get_address() #参数:#row_absolute(bool ,默认为True)–设置为True可以将引用的行部分作为绝对引用返回。#column_absolute(bool,默认为True)–设置为True可以将引用的列部分作为绝对引用返回。#include_sheetname(bool ,默认为False)–设置为True可以在地址中包含工作表名称。#external(bool ,默认为False)–设置为True以返回带有工作簿和工作表名称的外部引用。#具体的情况大家可以传入几个参数试试xw.Range ('A1:B2').height # 返回单元格(范围)的高度xw.Range ('A1:B2').width # 返回范围的宽度# 获取范围的高度(以磅为单位)xw.Range ('B2:C4').row_height # 设置范围的高度(以磅为单位)xw.Range ('B2:C4').row_height = 15
那么Xlwings是如何获取一个Range的行列数呢,以及其他的一些操作呢,我们来看以下的代码:
# 获取范围行和范围列xw.Range ('B2:C4').rows # 返回一个RangeRows对象,该对象表示指定范围内的行。xw.Range ('B2:C4').columns # 返回一个RangeRows对象,该对象表示指定范围内的列。xw.Range('B2:C4').rows.count # 获取范围行# 获取范围列xw.Range('B2:C4').columns.count xw.Range ('B2').left # 返回从A列的左边缘到范围左边缘的距离xw.Range ('B2').top # 返回从第1行的顶部边缘到范围的顶部边缘的距离xw.Range ('A1').hyperlink # 返回单元格中的超链接(对多个单元格没效)# 插入单元格xw.Range ('A3').insert(shift='right') #返回指定范围的右下角单元格range = xw.Range ('A1:C4').last_cell range.last_cell.row # 4range.last_cell.column # 3xw.Range("A4:C4").api.merge() # 合并单元格通过pywin32的api调用mergexw.Range("A4:C4").api.unmerge()# 拆分单元格xw.Range('A1').number_format # 获取设置Range的number_format# 设置Range的number_formatxw.Range('A1:C3').number_format = '0.00%' xw.Range('A1:A3').paste() # 将剪贴板中的范围粘贴到指定范围# 调整指定范围的大小xw.Range('A1:A3').resize(row_size = None,column_size = None ) # 选定单元格进行移动xw.Range('B2:C4').offset(row_offset=0,column_offset=0) #row_offset行偏移,column_offset列偏移xw.Range('B2:C4').shape # 以数组的形式返回所选范围的值xw.Range('B2:C4').sheet # 返回Range所属的Sheet对象xw.Range('B2:C4').size # 返回所选范围单元格个数(元素个数)
这里想到一个参数:在读值的时候如果想将行或列方向信息需要保留下来,需要设置options的参数值。
请分析这两行代码的输出:
xw.Range('B2:C4').options(ndim=2).valuexw.Range('A1:C1').options(ndim=2).value
四、小结
大家可以看出,这些API的知识还是很丰富的,这也是Xlwings强大的地方,当然了这些小操作结合起来就会有意想不到的效果。介绍了这么多的API知识,相必你也跃跃欲试了,赶快操作起来吧!