Chart类
Chart类
封装表示单个 Excel 图表的对象。
Chart 类型公开以下成员：
特性
| 属性 | 描述 |
|---|---|
| style | 获取和设置内置样式。 |
| chart_object | 代表图表形状； |
| hide_pivot_field_buttons | 指示仅当图表为数据透视图时是否隐藏数据透视图字段按钮。 |
| pivot_options | 指定图表上显示的枢轴控件 |
| pivot_source | 源是数据透视表的数据。 如果 PivotSource 不为空，则图表为数据透视图。 |
| 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 调整图表大小以匹配图表工作表窗口的大小，则为 true。 |
| worksheet | 获取包含此图表的工作表。 |
| shapes | 返回此图表中的所有绘图形状。 |
| print_size | 获取和设置打印图表大小。 |
| type | 获取或设置图表的类型。 |
| n_series | 获取表示图表中数据系列的 SeriesCollection 集合。 |
| filtered_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 | 获取或设置一个值，该值指示是否显示图表图例。默认为 true。 |
| is_rectangular_cornered | 获取或设置一个值，该值指示图表区域是否为矩形角。 默认为 true。 |
| show_data_table | 获取或设置一个值，该值指示图表是否显示数据表。 |
| first_slice_angle | 获取或设置第一个饼图或圆环图切片的角度（以度为单位）（从垂直方向顺时针方向）。 仅适用于饼图、3D 饼图和圆环图（0 到 360）。 |
| gap_width | 返回或设置条形或列簇之间的间距，以条形或列宽度的百分比表示。 该属性的值必须介于 0 到 500 之间。 |
| gap_depth | 获取或设置 3D 图表中数据系列之间的距离，以标记宽度的百分比表示。 该属性的值必须介于 0 到 500 之间。 |
| floor | 返回代表 3D 图表墙的 Chart.floor 对象。 |
| walls | 返回代表 3D 图表墙的 Chart.walls 对象。 |
| back_wall | 返回代表 3D 图表后墙的 Chart.walls 对象。 |
| side_wall | 返回代表 3D 图表侧壁的 Chart.walls 对象。 |
| walls_and_gridlines_2d | 如果在 3D 图表上以二维方式绘制网格线，则为 True。 |
| rotation_angle | 表示 3D 图表视图的旋转（绘图区域绕 z 轴的旋转，以度为单位）。 |
| elevation | 表示 3D 图表视图的高度（以度为单位）。 |
| right_angle_axes | 如果图表轴成直角，则为 true。仅适用于 3-D 图表（Column3D 和 3-D 饼图除外）。 |
| auto_scaling | 如果 Microsoft Excel 缩放 3D 图表，使其大小更接近等效的 2D 图表，则为 true。 RightAngleAxes 属性必须为 True。 |
| height_percent | 返回或设置 3D 图表的高度占图表宽度的百分比（介于 5% 和 500% 之间）。 |
| perspective | 返回或设置 3D 图表视图的透视图。必须介于 0 到 100 之间。 如果 RightAngleAxes 属性为 True，则忽略此属性。 |
| is_3d | 指示图表是否为 3d 图表。 |
| depth_percent | 将 3D 图表的深度表示为图表宽度的百分比（20% 到 2000% 之间）。 |
| actual_chart_size | 获取图表的实际大小（以像素为单位）。 |
| placement | 表示图表附加到其下方单元格的方式。 |
| page_setup | 表示此图表中的页面设置描述。 |
| line | 获取线路。 |
方法
| 方法 | 描述 |
|---|---|
| calculate | 计算绘图区域、轴的自定义位置（如果它们的位置是自动分配的）。 |
| calculate | 使用图表计算选项计算绘图区域和轴的自定义位置（如果它们的位置是自动分配的）。 |
| to_image | 创建图表图像并将其保存到文件中。 文件名的扩展名决定了图像的格式。 |
| to_image | 创建图表图像并将其保存到指定图像类型的文件中。 |
| to_image | 创建图表图像并将其保存到 Jpeg 格式的文件中。 |
| to_image | 创建图表图像并将其保存到 Jpeg 格式的流中。 |
| to_image | 创建图表图像并将其以指定格式保存到流中。 |
| to_image | 创建图表图像并将其保存到文件中。 文件名的扩展名决定了图像的格式。 |
| to_image | 创建图表图像并将其以指定格式保存到流中。 |
| to_pdf | 将图表保存为 pdf 文件。 |
| to_pdf | 将图表保存为 pdf 文件。 |
| to_pdf | 创建图表 pdf 并将其保存到流中。 |
| to_pdf | 创建图表 pdf 并将其保存到流中。 |
| is_refered_by_chart | 返回图表是否引用单元格。 |
| is_cell_refered_by_chart | 返回图表是否引用单元格。 |
| is_chart_data_changed | 检测图表的数据源是否已更改。 |
| refresh_pivot_data | 从数据透视表数据源刷新数据透视图的数据。 |
| change_template | 使用预设模板更改图表类型。 |
| move | 将图表移动到指定位置。 |
| get_actual_size | 获取图表的实际大小（以像素为单位）。 |
| has_axis | 返回图表上存在哪些轴。 |
| switch_row_column | 切换行/列。 |
| get_chart_data_range | 获取图表的数据源范围。 |
| set_chart_data_range | 指定图表的数据范围。 |
例子
以下代码展示了如何使用.Net代码创建图表。
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"
