Chart¶

类 Chart(名称或索引=None, 实现=None)¶

图表对象是的一个成员charts集合访问它们：

>>> import xlwings as xw
>>> sht = xw.books['Book1'].sheets[0]
>>> sht.charts[0]  # or sht.charts['ChartName']
<Chart 'Chart 1' in <Sheet [Book1]Sheet1>>

属性 api¶: 返回所使用引擎的原生对象 (pywin32或appscriptobj) 使用的引擎的成员。

在版本 0.9.0 中添加。

属性图表类型¶

返回和设置图表的图表类型。可用的图表类型如下：

3d_area, 3d_area_stacked, 3d_area_stacked_100, 3d_bar_clustered, 3d_bar_stacked, 3d_bar_stacked_100, 3d_column, 3d_column_clustered, 3d_column_stacked, 3d_column_stacked_100, 3d_line, 3d_pie, 3d_pie_exploded, area, area_stacked, area_stacked_100, bar_clustered, bar_of_pie, bar_stacked, bar_stacked_100, bubble, bubble_3d_effect, column_clustered, column_stacked, column_stacked_100, combination, cone_bar_clustered, cone_bar_stacked, cone_bar_stacked_100, cone_col, cone_col_clustered, cone_col_stacked, cone_col_stacked_100, cylinder_bar_clustered, cylinder_bar_stacked, cylinder_bar_stacked_100, cylinder_col, cylinder_col_clustered, cylinder_col_stacked, cylinder_col_stacked_100, doughnut, doughnut_exploded, line, line_markers, line_markers_stacked, line_markers_stacked_100, line_stacked, line_stacked_100, pie, pie_exploded, pie_of_pie, pyramid_bar_clustered, pyramid_bar_stacked, pyramid_bar_stacked_100, pyramid_col, pyramid_col_clustered, pyramid_col_stacked, pyramid_col_stacked_100, radar, radar_filled, radar_markers, stock_hlc, stock_ohlc, stock_vhlc, stock_vohlc, surface, surface_top_view, surface_top_view_wireframe, surface_wireframe, xy_scatter, xy_scatter_lines, xy_scatter_lines_no_markers, xy_scatter_smooth, xy_scatter_smooth_no_markers

添加于版本 0.1.1。

删除()¶: 删除图表。

属性高度¶: 返回或设置表示图表高度的点数。

属性左侧¶: 返回或设置表示图表水平位置的点数。

属性名称¶: 返回或设置图表的名称。

属性父级¶: 返回图表的父对象。

在版本 0.9.0 中添加。

设置源数据(数据源)¶

为图表设置源数据范围。

参数¶

数据源Range: 范围对象，例如xw.books['Book1'].sheets[0].range('A1')

导出为 PDF(路径=None, 显示=None, 质量='标准')¶

将图表导出为 PDF。

参数¶

路径字符串或路径类似对象，默认为 None: 您希望存储 PDF 的路径。如果 Excel 文件已保存，则默认为与 Excel 文件相同目录下的图表名称；否则为当前工作目录。
显示布尔值，默认为False: 创建后，使用默认应用程序打开 PDF 文件。
质量字符串，默认值'standard': PDF 文件的质量。可以是'standard'或'minimum'.

添加于版本 0.26.2。

导出为 PNG(路径=None)¶

将图表导出为 PNG 格式的图片。

参数¶

路径字符串或路径类似对象，默认为 None: 您希望存储图片的路径。如果 Excel 文件已保存，则默认为与 Excel 文件相同目录下的图表名称；否则为当前工作目录。

添加于版本 0.24.8。

属性顶部¶: 返回或设置表示图表垂直位置的点数。

属性宽度¶: 返回或设置表示图表宽度的点数。