Objeto ChartGroups (Excel)

Representa uma ou mais sequências plotadas em um gráfico com o mesmo formato.

Comentários

Uma coleção ChartGroups é uma coleção de todos os objetos ChartGroup no gráfico especificado. Um gráfico contém um ou mais grupos de gráficos, cada grupo gráfico contém um ou mais objetos de série e cada seqüência contém um ou mais objetos de pontos. Por exemplo, um único gráfico pode conter um grupo de gráficos de linha, que contém todas as séries plotadas com o formato de gráfico de linhas e um grupo de gráficos de barras, contendo todas as séries plotadas com o formato de gráfico de barras.

Use o método ChartGroups do objeto Chart para retornar a coleção ChartGroups .

O exemplo seguinte exibe o número de grupos gráficos no gráfico incorporado 1 da planilha 1.

MsgBox Worksheets(1).ChartObjects(1).Chart.ChartGroups.Count

Use ChartGroups (index), onde index é o número de índice do grupo gráfico, para retornar um único objeto ChartGroup . O exemplo a seguir adiciona linhas verticais ao grupo gráfico 1 na planilha de gráfico 1.

Charts(1).ChartGroups(1).HasDropLines = True

Se o gráfico tiver sido ativado, você poderá usar o ActiveChart.

Charts(1).Activate 
ActiveChart.ChartGroups(1).HasDropLines = True

Como o número de índice para um determinado grupo gráfico pode mudar se o formato do gráfico usado para este grupo for alterado, pode ser mais fácil usar um dos métodos de atalho de grupo gráfico nomeados para retornar um determinado grupo gráfico. O método PieGroups retorna a coleção de grupos de gráficos de pizza em um gráfico, o método LineGroups retorna a coleção de grupos de gráficos de linhas e assim por diante. Cada um destes métodos pode ser usado com um número de índice para retornar um único objeto ChartGroup ou sem um número do índice para retornar uma coleção ChartGroups.

Métodos

• Item

Propriedades

• Aplicativo
• Count
• Creator
• Parent

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.