rpa_excel_addSheet

新建一个sheet

1. 函数

rpa_excel_addSheet(excelId, sheetName)

• excelId：Excel标识符，通过rpa_excel_open接口返回；
• sheetName：字符串类型，新sheet的名称；

2. 返回值

bool类型，True表示成功，False表示失败，通过rpa_getLastErrorCode()获取错误码，rpa_getLastErrorMsg()获取错误信息。

3. 示例

#打开excel文件
excelTest = rpa_excel_open("d:/test.xlsx")

#打开失败结束流程
if not excelTest:
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())
    rpa_exit()

#新建一个sheet  若失败打印错误信息
if False == rpa_excel_addSheet(excelTest, "SheetTest"):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#从第一个sheet中读取单元格B2的数据
data = rpa_excel_read(excelTest, 1,1, 0)

#若字符串长度为0，则可能发生了错误，可获取错误码进行校验
if len(data) == 0:
    if  RpaError.code_success != rpa_getLastErrorCode():
        print(rpa_getLastErrorCode())
        print(rpa_getLastErrorMsg())

#向名称为“SheetTest”的sheet中的E3单元格写入数据 若失败打印错误信息
if False == rpa_excel_write(excelTest, data , 2, 4, 'SheetTest'):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#将第一个sheet的名称改为SheetRename  若失败打印错误信息
if False == rpa_excel_renameSheet(excelTest, 0, 'SheetRename'):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#打印第一个sheet中数据区域的行数
print(rpa_excel_rowCount(excelTest, 0))

#打印名称为“SheetTest”的sheet中数据区域的列数
print(rpa_excel_columnCount(excelTest, 'SheetTest'))

#打印sheet的总数
print(rpa_excel_sheetCount(excelTest))

#打印所有sheet名称的列表
print(rpa_excel_sheetNames(excelTest))

#将第一个sheet中A1至E5区域的数据复制到剪贴板中  若失败打印错误信息
if False == rpa_excel_copy(excelTest, 0, 0, 4, 4, 0):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#将剪贴板中数据写入名称为“SheetTest”的sheet中从D4开始的区域  若失败打印错误信息
if False == rpa_excel_paste(excelTest, 3, 3, "SheetTest"):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#保存Excel文件 若失败打印错误信息
if False == rpa_excel_save(excelTest):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())

#关闭Excel文件  若失败打印错误信息
if False == rpa_excel_close(excelTest):
    print(rpa_getLastErrorCode())
    print(rpa_getLastErrorMsg())