Series类
Series类
封装表示图表中单个数据系列的对象。
Series 类型公开以下成员：
特性
| 属性 | 描述 |
|---|---|
| is_filtered | 表示该系列是否被选择或过滤。True 表示该系列被过滤，并且不会显示在图表上。 |
| 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 | 表示曲线平滑。 如果折线图或散点图的曲线平滑功能打开，则为 True。 仅适用于由折线图连接的折线图和散点图。 |
| shadow | 如果该系列有阴影，则为真。 |
| has_3d_effect | 如果该系列具有三维外观，则为真。 仅适用于气泡图。 |
| bar_3d_shape_type | 获取或设置与 3D 条形图或柱形图一起使用的 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 | 如果折线图具有高低线，则为 true。 仅适用于折线图。 |
| hi_lo_lines | 返回一个 HiLoLines 对象，该对象表示折线图上系列的高低线。 仅适用于折线图。 |
| has_series_lines | 如果堆积柱形图或条形图具有系列线或则为 True 如果饼图或饼图条形图的两个部分之间有连接线。 仅适用于堆叠柱形图、条形图、饼图或饼图。 |
| series_lines | 返回一个 SeriesLines 对象，该对象表示堆积条形图或堆积柱形图的系列线。 仅适用于堆积条形图和堆积柱形图。 |
| has_drop_lines | 如果图表有垂线，则为 true。 仅适用于折线图或面积图。 |
| drop_lines | 返回一个 Line 对象，该对象表示折线图或面积图上系列的下降线。仅适用于折线图或面积图。 |
| has_up_down_bars | 如果折线图具有向上和向下条形图，则为 true。 仅适用于折线图。 |
| up_bars | 返回一个 DropBars 对象，该对象表示折线图上的向上条形。 仅适用于折线图。 |
| down_bars | 返回一个 DropBars 对象，该对象表示折线图上的下降条。仅适用于折线图。 |
| is_color_varied | 表示点的颜色是否变化。 该图表必须仅包含一个系列。 |
| gap_width | 返回或设置条形或列簇之间的间距，以条形或列宽度的百分比表示。 该属性的值必须介于 0 到 500 之间。 |
| first_slice_angle | 获取或设置第一个饼图或圆环图切片的角度（以度为单位）（从垂直方向顺时针方向）。 仅适用于饼图、3D 饼图和圆环图（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 | 如果图表组显示负气泡，则为 true。仅适用于气泡图。 |
| doughnut_hole_size | 返回或设置圆环图组中孔的大小。 孔尺寸以图表尺寸的百分比表示，介于 10% 和 90% 之间。 |
| explosion | 打开的饼图切片与饼图中心的距离以饼图直径的百分比表示。 |
| has_radar_axis_labels | 如果雷达图具有类别轴标签，则为 true。仅适用于雷达图。 |
| has_leader_lines | 如果该系列有引导线，则为真。 |
| leader_lines | 表示图表上的引导线。引导线将数据标签连接到数据点。 该对象不是一个集合；而是一个集合。没有任何对象代表一条引导线。 |
| legend_entry | 根据本系列获取图例条目。 |
| shape_properties | 获取 ShapePropertyCollection 对象，该对象保存 Series 的视觉形状属性。 |
方法
| 方法 | 描述 |
|---|---|
| move | 向上或向下移动系列。 |
例子
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")
