SeriesCollection类
SeriesCollection类
封装 Series 个对象的集合。
SeriesCollection 类型公开以下成员：
属性
| 属性 | 描述 |
|---|---|
| category_data | 获取或设置类别轴值的范围。 它可以是一个单元格区域（例如“d1:e10”）， 或一系列值（例如，“{2,6,8,10}”）。 |
| second_category_data | 获取或设置第二类别轴值的范围。 它可以是一个单元格区域（例如“d1:e10”）， 或一系列值（例如，“{2,6,8,10}”）。 仅当某些 ASeries 绘制在第二轴上时才有效。 |
| is_color_varied | 表示点的颜色是否变化。 |
| capacity | 获取或设置数组列表可包含的元素数量。 |
方法
| 方法 | 描述 |
|---|---|
add(self, area, is_vertical) | 将 Series 集合添加到图表。 |
add(self, area, is_vertical, check_labels) | 将 Series 集合添加到图表。 |
copy_to(self, array) | 将整个数组列表复制到兼容的一维数组列表，从目标数组列表的开头开始。 |
copy_to(self, index, array, array_index, count) | 从目标数组列表的指定索引开始，将数组列表中的一系列元素复制到兼容的一维数组列表中。 |
index_of(self, item, index) | 搜索指定的对象并返回从指定索引延伸到最后一个元素的数组列表中元素范围内第一个出现的从零开始的索引。 |
index_of(self, item, index, count) | 搜索指定的对象并返回从指定索引开始并包含指定数量元素的数组列表中元素范围内第一次出现的从零开始的索引。 |
last_index_of(self, item) | 搜索指定的对象并返回整个数组列表中最后一次出现的从零开始的索引。 |
last_index_of(self, item, index) | 搜索指定的对象并返回从第一个元素延伸到指定索引的数组列表中元素范围内的最后一个出现的从零开始的索引。 |
last_index_of(self, item, index, count) | 搜索指定的对象并返回包含指定数量的元素并以指定索引结束的数组列表中元素范围内的最后一个出现的从零开始的索引。 |
get_series_by_order(self, order) | 按顺序获取Series元素。 |
change_series_order(self, source_index, dest_index) | 直接改变两个系列的顺序。 |
swap_series(self, source_index, dest_index) | 直接改变两个系列的顺序。 |
set_series_names(self, start_index, area, is_vertical) | 设置图表中所有系列的名称。 |
add_r1c1(self, area, is_vertical) | 将 Series 集合添加到图表。 |
binary_search(self, item) | 使用默认比较器在整个排序数组列表中搜索元素，并返回该元素从零开始的索引。 |
例子
from aspose.cells import Workbook
from aspose.cells.charts import ChartType
# 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"
chart.n_series.add("A1:B4", True)
# Setting the data source for the category data of NSeries
chart.n_series.category_data = "C1:C4"
# Saving the Excel file
workbook.save("book1.xls")
