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_type
がxlSrcExternal
の時に使用するものなので、現在時点では実装されていません。- 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_type
がxlSrcExternal
の時に使用するものなので、現在時点では実装されていません。- 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>>