xbot.app.databook
概述
databook接口主要功能是对影刀内置的数据表格进行处理，如设置行内容、获取行内容、遍历行内容等
详情
get_row
获取数据表格指定行内容
get_row(row_num)
参数
- row_num：指定行号，行号从1开始
返回值
- List[str]：返回读取到的内容列表，如['a', 'b', 'c', 'd']
示例
获取数据表格第一行内容
from xbot import app
def main(args):
list_value = app.databook.get_row(1)
set_row
设置数据表格行内容
set_row(row_num, values, begin_column_name = 'A')
参数
row_num：要设置的数据表格行号，行号从1开始
values：要设置的值，必须是一个字符列表类型，如['a', 'b', 'c']
begin_column_name：设置开始的单元格列名，默认值为A列
返回值
无
示例1
设置数据表格第 1 行第 A 列单元格的值为 hello world
from xbot import app
def main(args):
app.databook.set_row(1, ['helloword'], begin_column_name = 'A')
append_row
在数据表格最后追加一行内容
append_row(values, begin_column_name = 'A')
参数
values：要设置的值, 必须是一个列表类型
begin_column_name：设置开始的单元格列名, 默认值为A
返回值
无
示例1
在数据表格的最后追加一行内容，起始写入单元格的列名为 B，内容为 [1,2,3,4,5,6,7,8,9,0]
from xbot import app
def main(args):
app.databook.append_row([1,2,3,4,5,6,7,8,9,0], begin_column_name = 'B')
insert_row
往数据表格中插入一行内容
insert_row(row_num, values, begin_column_name = 'A')
参数
row_num：插入位置的行号，行号从1开始
values：要设置的值，必须是一个列表类型
begin_column_name：设置开始的单元格列名，默认值为A
返回值
- 无
示例1
往数据表格第 10 行插入一条记录，行开始单元格列名为 A 插入值为 [1,2,3,4,5,6,7,8,9,0]
from xbot import app
def main(args):
app.databook.insert_row(10, [1,2,3,4,5,6,7,8,9,0], begin_column_name = 'A')
remove_row
移除数据表的某一行内容
remove_row(row_num)
参数
- row_num：要移除的行号
返回值
无
示例1
移除数据表格中第 10 行的数据
from xbot import app
def main(args):
app.databook.remove_row(10)
get_cell
获取数据表格指定单元格内容
get_cell(row_num, col_name)
参数
row_num：指定单元格的行号
col_name：指定单元格的列名
返回值
- any：返回数据表格指定单元格内容
示例1
获取数据表格第 10 行第 B 列单元中的内容
from xbot import app
def main(args):
value = app.databook.get_cell(10, 'B')
set_cell
设置数据表格指定单元格内容
set_cell(row_num, col_name, value)
参数
row_num：指定单元格的行号
col_name：指定单元格的列名
value：要设置到单元格中的内容
返回值
无
示例1
设置数据表格第 10 行第 B 列单元格的值为 helloword
from xbot import app
def main(args):
app.databook.set_cell(10, 'B', 'helloword')
set_column
设置数据表格列内容
set_column(col_name, values, begin_row_num = 1)
参数
col_name：需要设置的列名
values：要设置的值, 必须是一个列表类型
begin_row_num：需要设置的列的起始行号，行号从1开始
返回值
无
示例1
从第 1 行开始设置第 A 列数据值为 [1,2,3,4,5,6,7,8,9,0]
from xbot import app
def main(args):
app.databook.set_column('A', [1,2,3,4,5,6,7,8,9,0], begin_row_num = 1)
clear
清空数据表格内容
clear()
参数
无
返回值
无
示例1
清空数据表格内容
from xbot import app
def main(args):
app.databook.clear()
get_row_count
获取数据表格的总行数
get_row_count()
参数
无
返回值
- int：返回数据表格的总行数
示例1
获取数据表格当前数据的总行数
from xbot import app
def main(args):
count = app.databook.get_row_count()
get_range
获取数据表格指定区域的内容
get_range(area_begin_row_num, area_begin_column_name, area_end_row_num, area_end_column_name)
参数
area_begin_row_num：起始单元格行号，行号从1开始
area_begin_column_name：起始单元格列名，列名从A开始
area_end_row_num：结束单元格行号, 行号从1开始
area_end_column_name：结束单元格列名，列名从A开始
返回值
- List[Tuple]：返回读取内容组合
示例1
获取数据表格 A1 单元格到 F3 单元格中的内容
from xbot import app
def main(args):
list_value = app.databook.get_range(1, 'A', 3, 'F')
set_range
设置数据表格指定区域内容
set_range(row_num, col_name, values)
参数
row_num：设置区域起始行号，行号从1开始
col_name：设置区域起始列名，列名从A开始
values：要设置的内容，必须是一个二维数组
返回值
无
示例1
设置数据表格从 A1 单元格开始的值为
from xbot import app
def main(args):
app.databook.set_range(1, 'A', [['1','2','3'],['a','b','c']])