Tables#

class Tables(impl)#

指定したシート内のすべての 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 で追加.

add(source=None, name=None, source_type=None, link_source=None, has_headers=True, destination=None, table_style_name='TableStyleMedium2')#

指定したシートに新しいTableを作成します。

Arguments#

sourcexlwings range, default None

データ ソースを表すxlwingsのrangeオブジェクト。

namestr, default None

テーブルの名前。デフォルトはExcelが自動生成する名前。

source_typestr, default None

現在のところ、デフォルトは xlSrcRange 。つまり、xlwingsのrangeオブジェクトの使用を前提とするものです。他のオプションは使用できません。

link_sourcebool, default None

source_typexlSrcExternal の時に使用するものなので、現在時点では実装されていません。

has_headersbool or str, default True

Indicates whether the data being imported has column labels. Defaults to True. Possible values: True, False, 'guess'

destinationxlwings range, default None

source_typexlSrcExternal の時に使用するものなので、現在時点では実装されていません。

table_style_namestr, default 'TableStyleMedium2'

Possible strings: 'TableStyleLightN' (where N is 1-21), 'TableStyleMediumN' (where N is 1-28), 'TableStyleDarkN' (where N is 1-11)

Returns#

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>>