Objeto ChartObjects (Excel)

Uma coleção de todos os objetos ChartObject na planilha de gráfico, folha de diálogo ou planilha especificada.

Comentários

Cada objeto ChartObject representa um gráfico interno. O objeto ChartObject atua como um contêiner para um objeto gráfico. Métodos e propriedades para o objeto ChartObject controlar a aparência e o tamanho do gráfico inserido na planilha.

Exemplo

Use o método ChartObjects do objeto Worksheet para retornar a coleção ChartObjects.

O exemplo a seguir exclui todos os gráficos incorporados na planilha chamada Sheet1.

Worksheets("sheet1").ChartObjects.Delete

Você não pode usar a coleção ChartObjects para chamar as seguintes propriedades e métodos:

• Propriedade Locked
• Propriedade Placement
• Propriedade PrintObject

Ao contrário da versão anterior, a coleção ChartObjects agora pode ler as propriedades de altura, largura, esquerda e superior.

Use o método Add para criar um novo gráfico interno vazio e adicioná-lo à coleção. Use o método ChartWizard do objeto Chart para adicionar dados e formatar o novo gráfico.

O exemplo a seguir cria um novo gráfico interno e, então, adiciona os dados das células A1:A20 como um gráfico de linhas.

Dim ch As ChartObject 
Set ch = Worksheets("sheet1").ChartObjects.Add(100, 30, 400, 250) 
ch.Chart.ChartWizard source:=Worksheets("sheet1").Range("a1:a20"), _ 
 gallery:=xlLine, title:="New Chart"

Use ChartObjects (index), onde index é o número ou nome de índice de gráfico incorporado, para retornar um único objeto. O exemplo a seguir define o padrão para a área do gráfico no Gráfico 1 incorporado na planilha chamada Sheet1.

Worksheets("Sheet1").ChartObjects(1).Chart. _ 
 CChartObjecthartArea.Format.Fill.Pattern = msoPatternLightDownwardDiagonal 

Métodos

• Add
• Copy
• CopyPicture
• Cut
• Delete
• Duplicate
• Item
• Select

Propriedades

• Application
• Count
• Creator
• Height
• Left
• Locked
• Parent
• Placement
• PrintObject
• ProtectChartObject
• ShapeRange
• Top
• Visible
• Width

Confira também

• Referência do modelo de objeto do Excel

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.