Extend Method

Microsoft Excel Visual Basic

Extend Method

       

Adds new data points to an existing series collection. Variant

expression.Extend(Source, Rowcol, CategoryLabels)

expression   Required. An expression that returns a SeriesCollection object.

Source   Required Variant. The new data to be added to the SeriesCollection object, either as a Range object or an array of data points.

Rowcol   Optional Variant. Ignored if Source is an array. Specifies whether the new values are in the rows or columns of the given range source. Can be one of the following XlRowCol constants: xlRows or xlColumns. If this argument is omitted, Microsoft Excel attempts to determine where the values are by the size and orientation of the selected range or by the dimensions of the array.

CategoryLabels   Optional Variant. Ignored if Source is an array. True to have the first row or column contain the name of the category labels. False to have the first row or column contain the first data point of the series. If this argument is omitted, Microsoft Excel attempts to determine the location of the category label from the contents of the first row or column.

Remarks

This method is not available for PivotChart reports.

Example

This example extends the series on Chart1 by adding the data in cells B1:B6 on Sheet1.

Charts("Chart1").SeriesCollection.Extend _
        Source:=Worksheets("Sheet1").Range("B1:B6")