Charts Collection

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Charts

A collection of all the chart sheets in the specified or active workbook. Each chart sheet is represented by a Chart object. This doesn’t include charts embedded on worksheets or dialog sheets. For information about embedded charts, see the Chart or ChartObject object.

Using the Charts Collection

Use the Charts property to return the Charts collection. The following example prints all chart sheets in the active workbook.

  Charts.PrintOut

Use the Add method to create a new chart sheet and add it to the workbook. The following example adds a new chart sheet to the active workbook and places the new chart sheet immediately after the worksheet named Sheet1.

  Charts.Add After:=Worksheets("Sheet1")

You can combine the Add method with the ChartWizard method to add a new chart that contains data from a worksheet. The following example adds a new line chart based on data in cells A1:A20 on the worksheet named Sheet1.

  With Charts.Add
    .ChartWizard source:=Worksheets("Sheet1").Range("A1:A20"), _
        Gallery:=xlLine, Title:="February Data"
End With

Use Charts(index), where index is the chart-sheet index number or name, to return a single Chart object. The following example changes the color of series one on chart sheet one to red.

  Charts(1).SeriesCollection(1).Interior.Color = RGB(255, 0, 0)

The Sheets collection contains all the sheets in the workbook (both chart sheets and worksheets). Use Sheets(index), where index is the sheet name or number, to return a single sheet.