Partilhar via


Método WorksheetBase.ChartObjects

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

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

Sintaxe

'Declaração
Public Function ChartObjects ( _
    index As Object _
) As Object
public 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 Microsoft.Office.Interop.Excel.ChartObject) ou uma coleção de todos os gráficos incorporados (um Microsoft.Office.Interop.Excel.ChartObjects) na planilha.

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.

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 demonstra como usar o ChartObjects método para obter a coleção de gráficos incorporados e um único gráfico incorporado. O exemplo usa primeiro o ChartObjects método para obter o Microsoft.Office.Interop.Excel.ChartObjects a coleção da planilha atual e criar um novo Microsoft.Office.Interop.Excel.ChartObject. Depois de formatar o novo Microsoft.Office.Interop.Excel.ChartObject e dando o Microsoft.Office.Interop.Excel.ChartObject um nome, o exemplo usa o ChartObjects método para obter o novo Microsoft.Office.Interop.Excel.ChartObject (indexados pelo seu nome) e exibe uma visualização de impressão do gráfico.

Este exemplo é para uma personalização em nível de documento.

Private Sub CreateAndPreviewChart()
    Me.Range("A1", "A3").Value2 = 11
    Me.Range("B1", "B3").Value2 = 55

    Dim ChartObjects1 As Excel.ChartObjects = _
        CType(Me.ChartObjects(), Excel.ChartObjects)
    Dim chartObject1 As Excel.ChartObject = _
        ChartObjects1.Add(100, 20, 400, 250)

    chartObject1.Chart.ChartWizard(Me.Range("A1", "B3"), _
        Excel.XlChartType.xl3DColumn, Title:="New Chart")
    chartObject1.Name = "NewChartObject"

    Dim chartObject2 As Excel.ChartObject = _
        CType(Me.ChartObjects("NewChartObject"), Excel.ChartObject)
    chartObject2.Chart.PrintPreview(False)
End Sub
private void CreateAndPreviewChart()
{
    this.Range["A1", "A3"].Value2 = 11;
    this.Range["B1", "B3"].Value2 = 55;

    Excel.ChartObjects ChartObjects1 =
        (Excel.ChartObjects)this.ChartObjects(missing);
    Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);

    chartObject1.Chart.ChartWizard(this.Range["A1", "B3"],
        Excel.XlChartType.xl3DColumn, missing, missing, missing,
        missing, missing, "New Chart", missing, missing, missing);
    chartObject1.Name = "NewChartObject";

    Excel.ChartObject chartObject2 =
        (Excel.ChartObject)this.ChartObjects("NewChartObject");
    chartObject2.Chart.PrintPreview(false);
}

Segurança do .NET Framework

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel