Objeto Chart (Excel)

Representa um gráfico em uma pasta de trabalho.

Comentários

O gráfico pode ser um gráfico interno (contido em um objeto ChartObject) ou uma planilha de gráfico separada.

A coleção Charts contém um objeto Chart para cada planilha de gráfico na pasta de trabalho. Use Charts (index), em que index é o nome ou o número do índice da planilha de gráfico, para retornar um único objeto Chart.

O número do índice do gráfico representa a posição da planilha de gráfico na barra da guia da pasta de trabalho. Charts(1) é o primeiro gráfico (à esquerda) na pasta de trabalho; Charts(Charts.Count) é o último (à direita).

Todas as planilhas de gráfico estão incluídas na contagem de índices, mesmo que estejam ocultas. O nome da planilha de gráfico é mostrado na guia da pasta de trabalho para o gráfico. Você pode usar a propriedade Name do objeto ChartObject para definir ou retornar o nome do gráfico.

O seguinte exemplo altera a cor da série 1 na planilha de gráfico 1.

Charts(1).SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbRed

O exemplo a seguir move o gráfico chamado Vendas até o fim da pasta de trabalho ativa.

Charts("Sales").Move after:=Sheets(Sheets.Count)

O objeto Chart também é membro da coleção Sheets, que contém todas as planilhas na pasta de trabalho (planilhas de gráfico e planilhas). Use Sheets (index), em que index é o nome ou o número do índice da planilha, para retornar uma única planilha.

Quando um gráfico for o objeto ativo, você poderá usar a propriedade ActiveChart para se referir a ele. Uma planilha de gráfico está ativa se o usuário a tiver selecionado ou se ela tiver sido ativada com o método Activate do objeto Chart ou o método Activate do objeto ChartObject.

O seguinte exemplo ativa a planinha de gráfico 1 e, em seguida, define o tipo e o título do gráfico.

Charts(1).Activate 
With ActiveChart 
 .Type = xlLine 
 .HasTitle = True 
 .ChartTitle.Text = "January Sales" 
End With

Um gráfico incorporado está ativo se o usuário o tiver selecionado, ou caso o objeto ChartObject no qual ele está contido tenha sido ativado com o método Activate.

O seguinte exemplo ativa o gráfico incorporado 1 na planilha 1 e, em seguida, define o tipo e o título do gráfico. Observe que após o gráfico incorporado ter sido ativado, o código neste exemplo será o mesmo que aquele no exemplo anterior. Usar a propriedade ActiveChart permite que você escreva um código do Visual Basic que pode se referir a um gráfico incorporado ou a uma planilha de gráfico (o que estiver ativo).

Worksheets(1).ChartObjects(1).Activate 
ActiveChart.ChartType = xlLine 
ActiveChart.HasTitle = True 
ActiveChart.ChartTitle.Text = "January Sales"

Quando uma planilha de gráfico é a planilha ativa, você pode usar a propriedade ActiveSheet para se referir a ela. O seguinte exemplo usa o método Activate para ativar a tabela de gráfico denominada Chart1 e, em seguida, define a cor interior para a série 1 no gráfico em azul.

Charts("chart1").Activate 
ActiveSheet.SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbBlue

Eventos

Métodos

Propriedades

Confira também

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.