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"

也可以看看