Series类

封装表示图表中单个数据系列的对象。

Series 类型公开了以下成员：

特性

属性	描述
layout_properties	表示布局的属性。
points	获取图表中一系列点的集合。
area	表示 Series 对象的背景区域。
border	表示 Series 对象的边框。
name	获取或设置数据系列的名称。
display_name	获取显示在图表图形上的系列名称。
count_of_data_values	获取数据值的个数。
is_vertical_values	指示数据源是否垂直。
values	表示图表系列的数据。
values_format_code	表示 Values 的 NumberList 的格式代码。
x_values	表示图表系列的 x 值。
bubble_sizes	获取或设置图表系列的气泡大小值。
trend_lines	返回一个对象，该对象表示该系列的所有趋势线的集合。
smooth	表示曲线平滑。如果为折线图或散点图打开曲线平滑，则为真。仅适用于由折线图连接的折线图和散点图。
shadow	如果系列有阴影，则为真。
has_3d_effect	如果该系列具有三维外观，则为真。仅适用于气泡图。
bar_3d_shape_type	获取或设置与 3-D 条形图或柱形图一起使用的 3D 形状类型。
bar_shape	获取或设置与 3-D 条形图或柱形图一起使用的 3D 形状类型。
data_labels	表示指定 ASeries 的 DataLabels 对象。
type	获取或设置数据系列的类型。
marker	获取 Series.marker。
plot_on_second_axis	指示该系列是否绘制在第二个值轴上。
x_error_bar	表示系列的 X 方向误差棒。
y_error_bar	表示系列的 Y 方向误差条。
has_hi_lo_lines	如果折线图有高低线，则为真。仅适用于折线图。
hi_lo_lines	返回一个 HiLoLines 对象，该对象表示折线图上一系列的高低线。仅适用于折线图。
has_series_lines	如果堆积柱形图或条形图具有系列线或如果 Pie of Pie 图表或 Bar of Pie 图表在两个部分之间有连接线。仅适用于堆积柱形图、条形图、饼图或条形饼图。
series_lines	返回一个 SeriesLines 对象，该对象表示堆积条形图或堆积柱形图的系列线。仅适用于堆积条形图和堆积柱形图。
has_drop_lines	如果图表有下降线，则为真。仅适用于折线图或面积图。
drop_lines	返回一个 Line 对象，该对象表示折线图或面积图上系列的下降线。仅适用于折线图或面积图。
has_up_down_bars	如果折线图有上下条，则为真。仅适用于折线图。
up_bars	返回一个 DropBars 对象，表示折线图上的向上条。仅适用于折线图。
down_bars	返回一个 DropBars 对象，表示折线图上的下降条。仅适用于折线图。
is_color_varied	表示点的颜色是否变化。图表必须仅包含一个系列。
gap_width	返回或设置条形或列簇之间的空间，作为条形或列宽的百分比。此属性的值必须介于 0 和 500 之间。
first_slice_angle	获取或设置第一个饼图或圆环图切片的角度，以度为单位（从垂直方向顺时针方向）。仅适用于饼图、3-D 饼图和圆环图，0 到 360。
overlap	指定条和柱的定位方式。可以是介于 – 100 和 100 之间的值。仅适用于二维条形图和二维柱形图。
second_plot_size	返回或设置饼图饼图或饼图条形图的次要部分的大小，作为主要馅饼大小的百分比。可以是 5 到 200 之间的值。
split_type	返回或设置一个值，该值指示如何确定哪些数据点位于第二个饼图或饼图中的饼图或饼图中的条形图饼形图。
split_value	返回或设置一个值，该值将用于确定哪些数据点在第二个饼图或条形图中饼饼图或条形饼图。
is_auto_split	指示阈值是否是自动的。
bubble_scale	获取或设置指定图表组中气泡的比例因子。它可以是从 0（零）到 300 的整数值，对应于默认大小的百分比。仅适用于气泡图。
size_represents	获取或设置气泡大小在气泡图上表示的值。
show_negative_bubbles	如果图表组显示负气泡，则为真。仅对气泡图有效。
doughnut_hole_size	返回或设置圆环图组中孔的大小。孔大小表示为图表大小的百分比，介于 10% 和 90% 之间。
explosion	开放饼图切片与饼图中心的距离表示为饼图直径的百分比。
has_radar_axis_labels	如果雷达图具有类别轴标签，则为真。仅适用于雷达图。
has_leader_lines	如果系列有引导线，则为真。
leader_lines	表示图表上的引导线。引导线将数据标签连接到数据点。该对象不是集合；没有代表单个引导线的对象。
legend_entry	根据该系列获取图例条目。
shape_properties	获取包含 Series 的视觉形状属性的 ShapePropertyCollection 对象。

方法

方法	描述
move(count)	向上或向下移动系列。

例子

from aspose.cells import Workbook
from aspose.cells.charts import ChartMarkerType, ChartType, FormattingType
from aspose.pydrawing import Color

# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding a sample value to "A1" cell
worksheet.cells.get("A1").put_value(50)
# Adding a sample value to "A2" cell
worksheet.cells.get("A2").put_value(100)
# Adding a sample value to "A3" cell
worksheet.cells.get("A3").put_value(150)
# Adding a sample value to "A4" cell
worksheet.cells.get("A4").put_value(200)
# Adding a sample value to "B1" cell
worksheet.cells.get("B1").put_value(60)
# Adding a sample value to "B2" cell
worksheet.cells.get("B2").put_value(32)
# Adding a sample value to "B3" cell
worksheet.cells.get("B3").put_value(50)
# Adding a sample value to "B4" cell
worksheet.cells.get("B4").put_value(40)
# Adding a sample value to "C1" cell as category data
worksheet.cells.get("C1").put_value("Q1")
# Adding a sample value to "C2" cell as category data
worksheet.cells.get("C2").put_value("Q2")
# Adding a sample value to "C3" cell as category data
worksheet.cells.get("C3").put_value("Y1")
# Adding a sample value to "C4" cell as category data
worksheet.cells.get("C4").put_value("Y2")
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding NSeries (chart data source) to the chart ranging from "A1" cell to "B4"
seriesIndex = chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
series = chart.n_series[seriesIndex]
# Setting the values of the series.
series.values = "=B1:B4"
# Changing the chart type of the series.
series.type = ChartType.LINE
# Setting marker properties.
series.marker.marker_style = ChartMarkerType.CIRCLE
series.marker.foreground_color_set_type = FormattingType.AUTOMATIC
series.marker.foreground_color = Color.black
series.marker.background_color_set_type = FormattingType.AUTOMATIC
# do your business
# Saving the Excel file
workbook.save("book1.xls")

也可以看看

PlotArea类 SeriesCollection类