Tables

类 Tables(实现)

所有对象的集合table指定工作表上的对象：

>>> import xlwings as xw
>>> xw.books['Book1'].sheets[0].tables
Tables([<Table 'Table1' in <Sheet [Book11]Sheet1>>,
        <Table 'Table2' in <Sheet [Book11]Sheet1>>])

添加于版本 0.21.0。

添加(数据源=None, 名称=None, source_type=None, link_source=None, has_headers=True, 目标位置=None, table_style_name='TableStyleMedium2')

在指定的工作表中创建一个表格。

参数

数据源xlwings 范围，默认值为 None

一个 xlwings 范围对象，表示数据源。

名称字符串，默认值为 None

表的名称。默认情况下，它使用 Excel 自动生成的名称。

source_type字符串，默认值为 None

当前默认为xlSrcRange，即期望是一个 xlwings 范围对象。目前不允许其他选项。

link_source布尔值，默认为 None

当前未实现，因为只有在source_type是xlSrcExternal.

has_headers布尔值或字符串，默认为 True

指示导入的数据是否有列标签。默认为True。可能的值：True, False, 'guess'

目标位置xlwings 范围，默认值为 None

当前未实现，因为在source_type是xlSrcExternal.

table_style_name字符串，默认为 ‘TableStyleMedium2’

可能的字符串：'TableStyleLightN'（其中 N 为 1-21），'TableStyleMediumN'（其中 N 为 1-28），'TableStyleDarkN'（其中 N 为 1-11）

返回值

Table

示例

>>> import xlwings as xw
>>> sheet = xw.Book().sheets[0]
>>> sheet['A1'].value = [['a', 'b'], [1, 2]]
>>> table = sheet.tables.add(source=sheet['A1'].expand(), name='MyTable')
>>> table
<Table 'MyTable' in <Sheet [Book1]Sheet1>>