xlwings 使用备忘

holmes8699 投稿日時は 8 日前 32 表示


import xlwings as xw

app = xw.App(visible=True, add_book=False)
app.display_alerts = False    # 关闭一些提示信息,可以加快运行速度。 默认为 True。
app.screen_updating = True    # 更新显示工作表的内容。默认为 True。关闭它也可以提升运行速度。
wb = app.books.add()
sht = wb.sheets.active
----------------
app = xw.App(visible=False, add_book=False)
# 不显示Excel消息框
app.display_alerts = False
# 关闭屏幕更新,可加快宏的执行速度
app.screen_updating = False
wb = app.books.open(excel_path)
sheet1 = wb.sheets[0]
---------------------------
with xw.App(visible=False,add_book=False) as app:
    app.display_alerts = True
    app.screen_updating = False
    wb = xw.Book('1.xlsx')
	sht = wb.sheets[0]  
    wb.save('1.xlsx')
    wb.close()

--------------------

'''工作簿'''
# wb = app.books.add()                   # 新建工作簿。
# wb = app.books.open(r'file_path')      # 打开现有的工作簿
# wb = app.books.active                  # 获取当前活动的工作簿

"""工作表"""
# sht = wb.sheets.active                 # 获取当前活动的工作表
# sht = wb.sheets[0]                     # 按索引获取工作表
# sht = wb.sheets['Sheet1']              # 按表名获取工作表
# sht1 = wb.sheets.add()                 # 新建工作表,默认新建的放在最前面。
# sht1 = wb.sheets.add('新建工作表', after=sht)   # 新建工作表,放在sht工作表后面。

""" 读取单元格 """
b3 = sht.range('b3')
# 获取 b3 中的值
v = b3.value
# 也可以根据行列号读取
b3_value = sht.range(3,2).value
# 读取一段区间内的值
a1_c4_value = sht.range('a1:c4').options(ndim=2).value       # 加上 option 读取二维的数据
a1_c4_value = sht.range((1,1),(4,3)).options(ndim=2).value   # 和上面读取的内容一样。

""" 写入 就是把值赋值给读取的单元格就可以了"""
sht.range(3,2).value = 'b3'

"""设置单元格大小"""
sht.autofit()    # 自动调整单元格大小。注:此方法是在单元格写入内容后,再使用,才有效。
sht.range(1,4).column_width = 5    # 设置第4列 列宽。(1,4)为第1行第4列的单元格
sht.range(1,4).row_height = 20     # 设置第1行 行高

"""设置单元格 字体格式"""
b3.color = 255,200,255         # 设置单元格的填充颜色
b3.api.Font.ColorIndex = 3     # 设置字体的颜色,具体颜色索引见下方。
b3.api.Font.Size = 24          # 设置字体的大小。
b3.api.Font.Bold = True        # 设置为粗体。
b3.api.HorizontalAlignment = -4108    # -4108 水平居中。 -4131 靠左,-4152 靠右。
b3.api.VerticalAlignment = -4130      # -4108 垂直居中(默认)。 -4160 靠上,-4107 靠下, -4130 自动换行对齐。
b3.api.NumberFormat = "0.00"          # 设置单元格的数字格式。

"""设置边框"""
# Borders(9) 底部边框,LineStyle = 1 直线。
b3.api.Borders(9).LineStyle = 1
b3.api.Borders(9).Weight = 3                # 设置边框粗细。

# Borders(7) 左边框,LineStyle = 2 虚线。
b3.api.Borders(7).LineStyle = 2
b3.api.Borders(7).Weight = 3

# Borders(8) 顶部框,LineStyle = 5 双点划线。
b3.api.Borders(8).LineStyle = 5
b3.api.Borders(8).Weight = 3

# Borders(10) 右边框,LineStyle = 4 点划线。
b3.api.Borders(10).LineStyle = 4
b3.api.Borders(10).Weight = 3

# Borders(5) 单元格内从左上角 到 右下角。
b3.api.Borders(5).LineStyle = 1
b3.api.Borders(5).Weight = 3

# Borders(6) 单元格内从左下角 到 右上角。
b3.api.Borders(6).LineStyle = 1
b3.api.Borders(6).Weight = 3

"""如果是一个区域的单元格,内部边框设置如下"""
# # Borders(11) 内部垂直边线。
# b3.api.Borders(11).LineStyle = 1
# b3.api.Borders(11).Weight = 3
# 
# # Borders(12) 内部水平边线。
# b3.api.Borders(12).LineStyle = 1
# b3.api.Borders(12).Weight = 3

"""合并拆分单元格"""
sht.range('C8:D8').api.merge()      # 合并单元格 C8 到 D8
sht.range('C8:D8').api.unmerge()    # 拆分单元格。

'''插入 、删除 一行'''
sht1.range('a3').api.EntireRow.Delete()     # 会删除 ’a3‘ 单元格所在的行。
sht1.api.Rows(3).Insert()                   # 会在第3行插入一行,原来的第3行下移。

'''插入 、删除 一列'''
sht1.range('c2').api.EntireColumn.Delete()  # 会删除 ’c2‘ 单元格所在的列。
sht1.api.Columns(3).Insert()                # 会在第3列插入一列,原来的第3列右移。(也可以用列的字母表示)

'''获取最大行数,和列数'''
'''方法一、选择sheet页面最右下角的单元格'''
# 区别 expand(), expand()只选中与之连续的单元格。
cell = sht1.used_range.last_cell
rows = cell.row
columns = cell.column
# 方法二、也可以用shape直接获取行数和列数,推荐使用。
rows, columns = sht1.used_range.shape

# cell = sht1.range("a1").expand("down")
# max_rows = cell.rows.count              # 获取最大行数


'''排序,删除重复值'''
# 排序使用方法:
# 1、选择需要排序的区域。这里用 'a2' 是因为排序的数据送从第二行开始的,第一行是标题,不应该参与排序。
# 2、选择按那一列进行排序 Key1=sht.range('c2').api, 这里选择的是按 第 C 列排序,所以这里选择 c1 和 c2 都可以。
# 3、Order1=1 为升序,2为降序。
sht1.range('a2',(rows,columns)).api.Sort(Key1=sht.range('c2').api, Order1=1)

# 删除重复值使用方法:
# RemoveDuplicates(3) 为按第3列内容进行删除重复项。
sht1.range('a2',(rows,columns)).api.RemoveDuplicates(3)


"""插入、读取公式"""
sht1.range('d1').formula = '=sum(e1+f1)'    # 插入公式
print(sht1.range('d1').formula)

'''同个表格复制、粘贴'''
# 复制 a2 到 a6 之间单元格的值,粘贴到'a15'中
sht.range('a2','a6').api.Copy(sht.range('a15').api)

'''跨表格复制、粘贴'''
my_values = sht_1.range('a2:d4').options(ndim=2).value    # 读取二维的数据
sht_2.range('a1').value = my_values

wb.save()
#wb.close()
#app.quit()    # quit() 有时关闭不了进程,及在后台该进程还在。
app.kill()     # 使用kill()关闭进程。



#插入图片
sheetpic.pictures.add(pic_path, left=sheetpic.range('B' + str(pic_row)).left, top=sheetpic.range('B' + str(pic_row)).top, width=148, height=148)

#写入公式
sheet2.range('M' + str(i)).formula = "=IF(ISNA(VLOOKUP(D{},[froom商品シール管理表.xlsx]sheet1!$A:AH,34,0)),"",(VLOOKUP(D{},[froom商品シール管理表.xlsx]sheet1!$A:AH,34,0)))".format(str(i+6),str(i+6))

#判断excel最后一行行号
total_rows = sheetXS.range('B10000').end('up').row
判断从上往下第一个不为空的行号   
total_rows = sheetXS.range('B1').end('down').row

操作工作表
1)工作表名

app.books[0].sheets[0].name = 'sheetName':设置工作表名
app.books[0].sheets[0].name:获取工作表名
app.books[0].sheets[0].book:获取工作表所属的工作簿
app.books[0].sheets[0].index:获取工作表的索引(从1开始)
2)行高列宽

app.books[0].sheets[0].autofit():自适应行高列宽
app.books[0].sheets[0].autofit(axis='rows'):自适应行高
app.books[0].sheets[0].autofit(axis='columns'):自适应列宽
3)导出工作表(不指定路径,默认保存到当前目录)

app.books[0].sheets[0].to_html():导出 HTML
app.books[0].sheets[0].to_pdf():导出 PDF(内容不能为空)
4)复制工作表

app.books[0].sheets('sheetName').copy():复制工作表为副本
name:(可选,str)副本的名字
before:(可选,sheet对象)复制到哪个工作表之前
after:(可选,sheet对象)复制到哪个工作表之后

3.3、删除工作表
app.books[0].sheets[0].clear_contents():删除文本但保留样式
app.books[0].sheets[0].clear_formats():删除样式但保留文本
app.books[0].sheets[0].clear():删除文本和样式
app.books[0].sheets[0].delete():删除工作表

4、读写单元格
单元格不需要创建,选中单元格「范围」,然后读写即可,一个 Range 对应一个单元格。

4.1、选择单元格
按照范围、位置,选择单元格,并返回单元格对象,有多种方式。

1)按照A1表示法(例:选中A1到B3范围的单元格)

sheet.range('A1')
sheet.range('A1:B2')
2)按照坐标位置,坐标从左上角起始

sheet.range(1, 1)
sheet.range((1, 1), (3, 4))
3)切片方式选择范围

sheet['A1']
sheet['A1:B2']
sheet[0, 0]
sheet[0:1, 0:4]
4)按照单元格名字

sheet.range('a1_name')
实例

import xlwings as xw

with xw.App(visible=True) as app:
    book = app.books[0]
    sheet = book.sheets[0]
    range1 = sheet.range('A1')
    print(range1)
    range2 = sheet.range('A1:B2')
    print(range2)
    range3 = sheet.range(1, 1)
    print(range3)
    range4 = sheet.range((1, 1), (3, 4))
    print(range4)
    print(sheet['A1'])
    print(sheet['A1:B2'])
    print(sheet[0, 0])
    print(sheet[0:1, 0:4])

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
输出:

<Range [工作簿1]Sheet1!$A$1>
<Range [工作簿1]Sheet1!$A$1:$B$2>
<Range [工作簿1]Sheet1!$A$1>
<Range [工作簿1]Sheet1!$A$1:$D$3>
<Range [工作簿1]Sheet1!$A$1>
<Range [工作簿1]Sheet1!$A$1:$B$2>
<Range [工作簿1]Sheet1!$A$1>
<Range [工作簿1]Sheet1!$A$1:$D$1>
1
2
3
4
5
6
7
8

4.2、写入数据到单元格
向指定单元格中写入数据,数据可以是单个值、一维列表、二维列表

sheet.range('A1').value = 'hello Excel'
sheet.range('A2').value = [1, 2, 3]
sheet.range('A3').value = [[11, 22], [33, 44]]
写入效果参见下图



提示:已经有数据的单元格,再次写入,会覆盖原来的数据,常用来修改单元格数据。


4.3、读取单元格的数据
按照A1表示法,读取指定范围内单元格的数据,读出的数据可以是单个数据、列表、二维列表形式。

sheet.range('A1').value
sheet.range('A2:C2').value
sheet.range('A3:B4').value
我们将上一步写入的数据读出来,输出结果如下:

hello Excel
[1.0, 2.0, 3.0]
[[11.0, 22.0], [33.0, 44.0]]
1
2
3

4.4、设置单元格样式
1)背景颜色

sheet.range('A1:A2').color = '#FF0000':按照颜色代码设置颜色
sheet.range('B1').color = (255, 255, 0):按照颜色坐标设置颜色
sheet.range('A2').color = None:去除背景颜色
sheet.range('A2').color is None:判断背景颜色是否为空
sheet.range('B1').color:获取背景颜色
2)行高列宽

sheet.range('A1').row_height:获取行高
sheet.range('A1').column_width:获取列宽
sheet.range('A1').row_height = 20:设置行高
sheet.range('A1').column_width = 20:设置列宽
sheet.range('A1').rows.autofit():自适应行高
sheet.range('A1').columns.autofit():自适应列宽
sheet.range('A1').autofit():自适应行高列宽
3)合并单元格

sheet.range('A1:C1').merge():合并单元格
sheet.range('B1:C1').unmerge():取消合并
sheet.range('A1').merge_area:返回指定单元格的合并范围,如果没有合并,就返回单元格本身
sheet.range('A1').merge_cells:判断是否包含合并单元格(True包含;False不包含)
4)函数公式

sheet.range('D1').formula = '=SUM(A1:C1)':设置函数公式
sheet.range('D1').formula:获取函数公式
5)单元格名字

sheet.range('A1').name = 'a1_name':设置单元格名字
sheet.range('A1').name:获取单元格名字
6)复制粘贴

sheet.range('A1').copy():将单元格的内容复制到剪贴板
sheet.range('A2').paste():将剪贴板的内容复制到单元格

4.4、删除单元格
删除指定范围的单元格、数据、样式

sheet.range('A1').clear_contents():删除数据但保留样式
sheet.range('A2').clear_formats():删除样式但保留数据
sheet.range('A3').clear():删除数据和样式
sheet.range('A1').delete():删除单元格