WPS 加载项开发 > 表格 API 参考 > SeriesCollection > 方法 > SeriesCollection.Add 方法
向 SeriesCollection 集合添加一个或多个新数据系列。

语法

表达式.Add(Source, Rowcol, SeriesLabels, CategoryLabels, Replace)

表达式   一个代表 SeriesCollection 对象的变量。

参数

名称 必选/可选 数据类型 说明
Source 必选 Variant 作为 Range 对象的新数据。
Rowcol 可选 XlRowCol 指定新值是位于指定区域的行中还是列中。
SeriesLabels 可选 Variant 如果第一行或第一列包含数据系列的名称，则为 True。如果第一行或第一列包含数据系列的第一个数据点，则为 False。如果省略此参数，ET 就尝试根据第一行或第一列中的内容确定系列名称的位置。
CategoryLabels 可选 Variant 如果第一行或第一列包含分类标签的名称，则为 True。如果第一行或第一列包含数据系列的第一个数据点，则为 False。如果省略此参数，ET 就尝试根据第一行或第一列中的内容确定分类标签的位置。
Replace 可选 Variant 如果 CategoryLabels 为 True 且 Replace 为 True，那么指定的分类将替换当前系列中存在的分类。如果 Replace 为 False，现有的分类将保留。默认值为 False。

返回值
一个代表新数据系列的 Series 对象。

说明

实际上，此方法不会像“对象浏览器”中所述的那样返回 Series 对象。此方法对数据透视表无效。

示例

本示例在 Chart1 中新建一个数据系列。新系列的数据源是 Sheet1 上的单元格区域 B1:B10。

示例代码 
Charts.Item("Chart1").SeriesCollection().Add(ActiveWorkbook.Worksheets.Item("Sheet1").Range("B1:B10"))

本示例在工作表 Sheet1 上的嵌入式图表中新建一个数据系列。

示例代码 
Worksheets.Item("Sheet1").ChartObjects(1).Activate()
ActiveChart.SeriesCollection().Add(Worksheets.Item("Sheet1").Range("B1:B10"))


请参阅