Chart类
Chart类
封装表示单个 Excel 图表的对象。
Chart 类型公开了以下成员:
特性
| 属性 | 描述 |
|---|---|
| style | 获取和设置内置样式。 |
| chart_object | 代表图表形状; |
| hide_pivot_field_buttons | 指示是否仅在图表为数据透视图时隐藏数据透视图字段按钮。 |
| pivot_options | 指定显示在图表上的数据透视控件 |
| pivot_source | 源是数据透视表的数据。
如果 PivotSource 不为空,则图表为 PivotChart。 |
| plot_by | 获取和设置是按行还是按列绘制。 |
| plot_empty_cells_type | 获取并设置如何绘制空单元格。 |
| plot_visible_cells | 指示是否仅绘制可见单元格。 |
| plot_visible_cells_only | 指示是否仅绘制可见单元格。 |
| display_na_as_blank | 指示是否将#N/A 显示为空白值。 |
| name | 获取和设置图表的名称。 |
| size_with_window | 如果 Microsoft Excel 调整图表大小以匹配图表工作表窗口的大小,则为真。 |
| worksheet | 获取包含此图表的工作表。 |
| shapes | 返回此图表中的所有绘图形状。 |
| print_size | 获取和设置打印的图表大小。 |
| type | 获取或设置图表的类型。 |
| n_series | 获取表示图表中数据系列的 SeriesCollection 集合。 |
| title | 获取图表的标题。 |
| sub_title | 获取图表的副标题。
仅适用于 ODS 格式文件。 |
| plot_area | 获取图表的绘图区域,其中包括轴刻度标签。 |
| chart_area | 获取工作表中的图表区域。 |
| category_axis | 获取图表的 X 轴。 |
| value_axis | 获取图表的 Y 轴。 |
| second_value_axis | 获取图表的第二个 Y 轴。 |
| second_category_axis | 获取图表的第二个 X 轴。 |
| series_axis | 获取图表的系列轴。 |
| legend | 获取图表图例。 |
| chart_data_table | 代表图表数据表。 |
| show_legend | 获取或设置一个值,该值指示是否显示图表图例。默认为真。 |
| is_rectangular_cornered | 获取或设置一个值,该值指示图表区域是否为矩形角。
默认为真。 |
| show_data_table | 获取或设置一个值,该值指示图表是否显示数据表。 |
| first_slice_angle | 获取或设置第一个饼图或圆环图切片的角度,以度为单位(从垂直方向顺时针方向)。仅适用于饼图、3-D 饼图和圆环图,0 到 360。 |
| gap_width | 返回或设置条形或列簇之间的空间,作为条形或列宽的百分比。
此属性的值必须介于 0 和 500 之间。 |
| gap_depth | 获取或设置 3-D 图表中数据系列之间的距离,以标记宽度的百分比表示。
此属性的值必须介于 0 和 500 之间。 |
| floor | 返回代表 3-D 图表的墙壁的 Chart.floor 对象。 |
| walls | 返回代表 3-D 图表的墙壁的 Chart.walls 对象。 |
| back_wall | 返回代表 3-D 图表后墙的 Chart.walls 对象。 |
| side_wall | 返回代表 3-D 图表侧壁的 Chart.walls 对象。 |
| walls_and_gridlines_2d | 如果在 3-D 图表上以二维方式绘制网格线,则为真。 |
| rotation_angle | 表示 3-D 图表视图的旋转(绘图区域围绕 z 轴的旋转,以度为单位)。 |
| elevation | 表示 3-D 图表视图的高度,以度为单位。 |
| right_angle_axes | 如果图表轴成直角则为真。仅适用于 3-D 图表(Column3D 和 3-D 饼图除外)。 |
| auto_scaling | 如果 Microsoft Excel 缩放 3-D 图表,使其在大小上更接近等效的 2-D 图表,则为真。
RightAngleAxes 属性必须为 True。 |
| height_percent | 返回或设置 3-D 图表的高度占图表宽度的百分比(介于 5% 和 500% 之间)。 |
| perspective | 返回或设置 3-D 图表视图的透视图。必须介于 0 和 100 之间。
如果 RightAngleAxes 属性为 True,则忽略此属性。 |
| is_3d | 指示图表是否为 3d 图表。 |
| depth_percent | 表示 3-D 图表的深度占图表宽度的百分比(介于 20% 和 2000% 之间)。 |
| actual_chart_size | 以像素为单位获取图表的实际大小。 |
| placement | 表示图表附加到其下方单元格的方式。 |
| page_setup | 表示此图表中的页面设置说明。 |
| line | 获取线路。 |
方法
例子
from aspose.cells import Workbook
from aspose.cells.charts import ChartType
workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"