概述

excel接口主要是针对excel的操作,如创建excel对象、打开excel文件等

详情

create

创建并返回excel对象

create(*, kind=’office’, visible=True)
参数:

  • kind:创建方式
    • office‘:使用 Microsoft Office 创建excel对象
    • ‘wps’:使用 WPS 创建excel对象
    • ‘openpyxl’:使用 Openpyxl 创建excel对象
  • visible:用于控制自动化操作是否用户级可见,并不限制自动化的能力,仅在office和wps下有效

返回值:

  • WorkBook:返回创建的excel对象

示例1:
使用 Microsoft Office 创建excel对象

  1. from xbot import excel
  2. def main(args):
  3. workbook = excel.create(kind='office', visible=True)

open

打开excel文件并返回excel对象

open(file_name, *, kind=’office’, visible=True)
参数:

  • file_name:excel文件路径
  • kind:打开方式
    • office‘:使用 Microsoft Office 打开excel文件
    • ‘wps’:使用 WPS 打开excel文件
    • ‘openpyxl’:使用 Openpyxl 打开excel文件
  • visible:用于控制自动化操作是否用户级可见,并不限制自动化的能力,仅在office和wps模式下可用

返回值:

  • WorkBook:返回打开的excel对象

示例1:
使用 Microsoft Office 打开excel文件:’D:\test.xlsx’

  1. from xbot import excel
  2. def main(args):
  3. workbook = excel.open('D:\\test.xlsx', kind='office', visible=True)

get_active_workbook

获取当前激活的excel

get_active_workbook(kink)
参数:

  • kind:打开方式
    • office‘:获取 office 当前激活的excel对象
    • ‘wps’:获取 WPS 当前激活的excel对象
    • ‘auto_check’:自动检查,优先获取 office 当前激活的excel对象,如果不存在则尝试获取 WPS 当前激活的excel对象,如果还不存在则抛出 ValueError 异常

返回值:

  • WorkBook:获取当前激活的excel对象

示例1:
获取当前激活的excel

  1. from xbot import excel
  2. def main(args):
  3. workbook = excel.get_active_workbook(kind='auto_check')