xbot.excel

概述

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

详情

create

创建并返回excel对象

create( * , kind='office', visible=True)

参数

• kind：创建方式
  • 'office'：使用 Microsoft Office 创建excel对象
  • 'wps'：使用 WPS 创建excel对象
  • 'openpyxl'：使用 Openpyxl 创建excel对象
  • 'auto_check'：自动检查，优先获取 office 当前激活的excel对象，如果不存在则尝试获取 WPS 当前激活的excel对象，如果还不存在则抛出 ValueError 异常
• visible：用于控制自动化操作是否用户级可见，并不限制自动化的能力，仅在office和wps下有效

返回值

• WorkBook：返回创建的excel对象

示例1

使用 Microsoft Office 创建excel对象

from xbot import excel

def main(args):
    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文件
  • 'auto_check'：自动检查，优先获取 office 当前激活的excel对象，如果不存在则尝试获取 WPS 当前激活的excel对象，如果还不存在则抛出 ValueError 异常
• visible：用于控制自动化操作是否用户级可见，并不限制自动化的能力，仅在office和wps模式下可用

返回值

• WorkBook：返回打开的excel对象

示例1

使用 Microsoft Office 打开excel文件：'D:\test.xlsx'

from xbot import excel

def main(args):
    workbook = excel.open('D:\\test.xlsx', kind='office', visible=True)

get_active_workbook

获取当前激活的excel

get_active_workbook(kind)

参数

• kind：打开方式
  • 'office'：获取 office 当前激活的excel对象
  • 'wps'：获取 WPS 当前激活的excel对象
  • 'openpyxl'：使用 Openpyxl 打开excel文件
  • 'auto_check'：自动检查，优先获取 office 当前激活的excel对象，如果不存在则尝试获取 WPS 当前激活的excel对象，如果还不存在则抛出 ValueError 异常

返回值

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

示例1

获取当前激活的excel

from xbot import excel

def main(args):
    workbook = excel.get_active_workbook(kind='auto_check')