Charts

class Charts(impl)

指定したシート内のすべての chart オブジェクトのコレクション:

>>> import xlwings as xw
>>> xw.books['Book1'].sheets[0].charts
Charts([<Chart 'Chart 1' in <Sheet [Book1]Sheet1>>,
        <Chart 'Chart 1' in <Sheet [Book1]Sheet1>>])

Added in version 0.9.0.

add(left=0, top=0, width=355, height=211)

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

Arguments

leftfloat, default 0

左位置（ポイント単位）

topfloat, default 0

上端位置（ポイント単位）

widthfloat, default 355

幅（ポイント単位）

heightfloat, default 211

高さ（ポイント単位）

Returns

Chart

例

>>> import xlwings as xw
>>> sht = xw.Book().sheets[0]
>>> sht.range('A1').value = [['Foo1', 'Foo2'], [1, 2]]
>>> chart = sht.charts.add()
>>> chart.set_source_data(sht.range('A1').expand())
>>> chart.chart_type = 'line'
>>> chart.name
'Chart1'

property api

使用しているエンジンのネイティブ オブジェクト(pywin32 オブジェクトまたは appscript オブジェクト)を返します。

property count

コレクションに含まれるオブジェクトの数を返します。