ChartSheetBase.ChartObjects Method

Gets an object that represents either a single embedded chart (a ChartObject object) or a collection of all the embedded charts (a ChartObjects object) on the sheet.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)


Public Function ChartObjects ( _
    index As Object _
) As Object
public Object ChartObjects(
    Object index


Return Value

Type: System.Object


This method is not equivalent to the Charts property. This method returns embedded charts; the Charts property returns chart sheets. Use the Chart property to return the Microsoft.Office.Interop.Excel.Chart object for an embedded chart.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.


The following code example uses the ChartObjects method to display whether the collection of embedded charts was created by Microsoft Office Excel.

Private Sub UseChartObjects()
    Globals.Sheet1.Range("A1", "A5").Value2 = 22
    Globals.Sheet1.Range("B1", "B5").Value2 = 55

    Me.SetSourceData(Globals.Sheet1.Range("A1", "B5"), _
    Me.ChartType = Excel.XlChartType.xlBarClustered

    Dim ChartObjects1 As Excel.ChartObjects = _
        CType(Me.ChartObjects(), Excel.ChartObjects)

    If ChartObjects1.Creator = Excel.XlCreator.xlCreatorCode Then
        MsgBox("The ChartObjects was created by Microsoft Office Excel.")
    End If
End Sub
private void UseChartObjects()
    Globals.Sheet1.Range["A1", "A5"].Value2 = 22;
    Globals.Sheet1.Range["B1", "B5"].Value2 = 55;

    this.SetSourceData(Globals.Sheet1.Range["A1", "B5"],
    this.ChartType = Excel.XlChartType.xlBarClustered;

    Excel.ChartObjects chartObjects =

    if (chartObjects.Creator == Excel.XlCreator.xlCreatorCode)
        MessageBox.Show("The ChartObjects was created by " + 
            "Microsoft Office Excel.");

.NET Framework Security

See Also


ChartSheetBase Class

Microsoft.Office.Tools.Excel Namespace