Método Chart.ChartObjects

Artigo
08/01/2011

Obtém um objeto representando um único gráfico incorporado (um ChartObject objeto) ou uma coleção de todos os gráficos incorporados (um ChartObjects objeto) na folha.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (em Microsoft.Office.Tools.Excel.dll)

Sintaxe

'Declaração
Function ChartObjects ( _
    Index As Object _
) As Object

Object ChartObjects(
    Object Index
)

Parâmetros

Index
Tipo: System.Object
O nome ou número do gráfico.Esse argumento pode ser uma matriz, para especificar mais de um gráfico.

Valor de retorno

Tipo: System.Object
Um objeto que representa tanto um único gráfico incorporado (um ChartObject objeto) ou uma coleção de todos os gráficos incorporados (um ChartObjects coleção) na folha.

Comentários

Esse método não é equivalente a Charts propriedade. Esse método retorna gráficos incorporados; o Charts propriedade retorna folhas de gráfico. Use o Chart propriedade para retornar o Chart o objeto para um gráfico incorporado.

Optional Parameters

Para obter informações sobre os parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria um Chart e, em seguida, usa o ChartObjects método para exibir ou não o gráfico foi criado por Microsoft Office Excel.

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

    Dim Chart1 As Microsoft.Office.Tools.Excel.Chart = _
        Me.Controls.AddChart(Me.Range("D2", "H12"), "Chart1")

    Chart1.SetSourceData(Me.Range("A1", "B5"), Excel.XlRowCol.xlColumns)
    Chart1.ChartType = Excel.XlChartType.xlColumnClustered

    Dim chartObjects1 As Excel.ChartObjects = _
        CType(Chart1.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()
{
    this.Range["A1", "A5"].Value2 = 22;
    this.Range["B1", "B5"].Value2 = 55;

    Microsoft.Office.Tools.Excel.Chart chart1 =
        this.Controls.AddChart(this.Range["D2", "H12"], 
        "chart1");

    chart1.SetSourceData(this.Range["A1", "B5"], 
        Excel.XlRowCol.xlColumns);
    chart1.ChartType = Excel.XlChartType.xlColumnClustered;

    Excel.ChartObjects chartObjects1 =
        (Excel.ChartObjects)chart1.ChartObjects(missing);

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

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiáveis.

Consulte também

Referência

Chart Interface

Namespace Microsoft.Office.Tools.Excel

Partilhar via