Método WorksheetBase.ChartObjects

Artigo
01/09/2014

Obtém um objeto que representa um único elemento gráfico inserido ( Microsoft.Office.Interop.Excel.ChartObject) ou uma coleção de todos os elementos gráficos inseridos ( 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 o número de gráfico.Este argumento pode ser uma matriz, para especificar mais de um gráfico.

Valor de retorno

Tipo: System.Object
Um objeto que representa um único elemento gráfico inserido ( Microsoft.Office.Interop.Excel.ChartObject) ou uma coleção de todos os elementos gráficos inseridos ( Microsoft.Office.Interop.Excel.ChartObjects) na planilha.

Comentários

Este método não é equivalente à propriedade de Charts . Esse método retorna elementos gráficos inseridos; os retornos de propriedade de Charts ícones um gráfico folhas.

Parâmetros Opcionais

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

Exemplos

O exemplo de código demonstra como usar o método de ChartObjects para obter a coleção de elementos gráficos inseridos e um único elemento gráfico inserido. O primeiro exemplo usa o método de ChartObjects para obter a coleção de Microsoft.Office.Interop.Excel.ChartObjects a planilha atual e para criar um novo Microsoft.Office.Interop.Excel.ChartObject. Após formatado novo Microsoft.Office.Interop.Excel.ChartObject e dada a Microsoft.Office.Interop.Excel.ChartObject ter um nome, o exemplo usa o método de ChartObjects para obter novo Microsoft.Office.Interop.Excel.ChartObject (indexado por seu nome) e exibe uma visualização de impressão de gráfico.

Este exemplo destina-se a uma personalização no 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();
    Excel.ChartObject chartObject1 = ChartObjects1.Add(100, 20, 400, 250);

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

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

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ável.

Consulte também

Referência

WorksheetBase Classe

Namespace Microsoft.Office.Tools.Excel

Compartilhar via