Classe ChartGroup (Excel VBA)

A classe ChartGroup representa uma ou mais sequências plotadas em um gráfico com o mesmo formato.

Set

Para usar uma variável de classe ChartGroup, ela primeiro precisa ser instanciada por exemplo

Dim chrg as ChartGroup
Set chrg = ActiveChart.ChartGroups(Index:=1)

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo ChartGroup: ChartGroups.Item e Chart.ChartGroups

For Each

Aqui está um exemplo de processamento dos itens ChartGroup em uma coleção.

Dim chrg As ChartGroup
For Each chrg In ActiveChart.ChartGroups()
	
Next chrg

Métodos

Estes são os principais métodos da classe

CategoryCollection - Retorna um objeto que representa uma coleção de todas as categorias visíveis uma coleção CategoryCollection no grupo de gráficos.

FullCategoryCollection - Retorna um objeto que representa uma coleção de todas as categorias visíveis e filtradas uma coleção CategoryCollection no grupo de gráficos.

SeriesCollection - Retorna um objeto que representa uma única série um objeto Series ou uma coleção de todas as séries (uma coleção SeriesCollection ) no gráfico ou grupo de gráficos.

ChartGroups.Item - Retorna um único objeto de uma coleção.

Propriedades

AxisGroup Retorna ou define o grupo do gráfico especificado. Leitura/gravação.

ActiveChart.ChartGroups(1).AxisGroup = xlPrimary

BinsCountValue Especifica o número de compartimentos no gráfico de histograma. Long de leitura/gravação.

ActiveChart.ChartGroups(1).BinsCountValue =

BinsOverflowEnabled Especifica se um compartimento para valores acima da propriedade BinsOverflowValue está habilitado. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).BinsOverflowEnabled = True

BinsOverflowValue Se uma propriedade BinsOverflowEnabled for true, especificará o valor acima do qual um compartimento de excedente é exibido. Double de leitura/gravação.

ActiveChart.ChartGroups(1).BinsOverflowValue =

BinsType Especifica como o eixo horizontal do gráfico de histograma é formatado, por tipo de compartimento. Leitura/gravação XlBinsType.

ActiveChart.ChartGroups(1).BinsType = xlBinsTypeAutomatic

BinsUnderflowEnabled Especifica se um compartimento para valores abaixo da propriedade BinsUnderflowValue está habilitado. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).BinsUnderflowEnabled = True

BinsUnderflowValue Se uma propriedade BinsUnderflowEnabled for true, especificará o valor abaixo do qual um compartimento de estouro negativo é exibido. Double de leitura/gravação.

ActiveChart.ChartGroups(1).BinsUnderflowValue =

BinWidthValue Especifica o número de pontos em cada intervalo. Double de leitura/gravação.

ActiveChart.ChartGroups(1).BinWidthValue =

BubbleScale Retorna ou define o fator de dimensionamento para balões no grupo de gráficos especificado. Pode ser um valor inteiro de 0 zero a 300, correspondente a uma porcentagem do tamanho padrão. Aplica-se apenas a gráficos de bolhas. Long de leitura/gravação.

ActiveChart.ChartGroups(1).BubbleScale = 200

DoughnutHoleSize Retorna ou define o tamanho do buraco em um grupo de gráficos de rosca. O tamanho do buraco é expresso como um percentual do tamanho do gráfico, entre 10 e 90%. Long de leitura/gravação.

ActiveChart.ChartGroups(1).DoughnutHoleSize = 10

DownBars Retorna um objeto DownBars que representa as barras inferiores em um gráfico de linhas. Aplica-se apenas a gráficos de linhas. Somente leitura.

Dim dbsDownBars As DownBars
Set dbsDownBars = ActiveChart.ChartGroups(1).DownBars

DropLines Retorna um objeto DropLines que representa as linhas de projeção de uma série em um gráfico de linhas ou gráfico de área. Aplica-se apenas a gráficos de linhas e a gráficos de áreas. Somente leitura.

Dim dlsDropLines As DropLines
Set dlsDropLines = ActiveChart.ChartGroups(1).DropLines

FirstSliceAngle Retorna ou define o ângulo do primeiro gráfico de pizza ou fatia de gráfico de rosca, em graus no sentido horário a partir da vertical. Aplica-se apenas a gráficos de pizza, pizza 3D e rosca. Pode ser um valor de 0 a 360. Long de leitura/gravação.

ActiveChart.ChartGroups(1).FirstSliceAngle = 30

GapWidth Gráficos de barras e de colunas: Retorna ou define o espaço entre grupos de barras ou colunas, como um percentual da largura da barra ou coluna.

ActiveChart.ChartGroups(1).GapWidth = 20

Has3DShading Retorna ou define a propriedade de sombreamento 3D de um objeto ChartGroup . Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).Has3DShading = True

HasDropLines True se o gráfico de linhas ou gráfico de área tem grades verticais. Só se aplica a gráficos de linhas e de área. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).HasDropLines = True

HasHiLoLines True se o gráfico de linhas tem linhas de máximo/mínimo. Só se aplica a gráficos de linhas. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).HasHiLoLines = True

HasRadarAxisLabels True se um gráfico de radar tem rótulos de eixo. Só se aplica a gráficos de radar. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).HasRadarAxisLabels = True

HasSeriesLines True se um gráfico de colunas ou de barras empilhadas tiver linhas de série ou se um gráfico pizza de pizza ou barra de pizza tiver linhas de conexão entre as duas seções. Aplica-se somente a barras empilhadas 2D, colunas empilhadas 2D, pizza de pizza ou barra de gráficos de pizza. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).HasSeriesLines = True

HasUpDownBars True se um gráfico de linhas tiver barras superiores e inferiores. Aplica-se somente a gráficos de linha. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).HasUpDownBars = True

HiLoLines Retorna um objeto HiLoLines que representa as linhas de máximo/mínimo para uma série em um gráfico de linhas. Aplica-se apenas a gráficos de linhas. Somente leitura.

Dim hllsHiLoLines As HiLoLines
Set hllsHiLoLines = ActiveChart.ChartGroups(1).HiLoLines

Index Retorna um valor Long que representa o número de índice do objeto dentro da coleção de objetos semelhantes.

Dim lngIndex As Long
lngIndex = ActiveChart.ChartGroups(1).Index

Overlap Especifica como barras e colunas são posicionadas. Pode ser um valor entre -100 e 100. Só se aplica a gráficos de colunas 2D e de barras 2D. Long de leitura/gravação.

ActiveChart.ChartGroups(1).Overlap =

Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveChart.ChartGroups(1).Parent

RadarAxisLabels Retorna um objeto TickLabels que representa os rótulos de eixo de radar do grupo de gráficos especificado. Somente leitura.

Dim tlsRadarAxisLabels As TickLabels
Set tlsRadarAxisLabels = ActiveChart.ChartGroups(1).RadarAxisLabels

SecondPlotSize Retorna ou define o tamanho da seção secundária de uma pizza de gráfico de pizza ou uma barra de gráfico de pizza, como uma porcentagem do tamanho da pizza principal. Pode ser um valor de 5 de 200. Long de leitura/gravação.

ActiveChart.ChartGroups(1).SecondPlotSize =

SeriesLines Retorna um objeto SeriesLines que representa as linhas de série de uma barra empilhada 2D, coluna empilhada 2D, pizza de pizza ou barra de gráfico de pizza. Somente leitura.

Dim slsSeriesLines As SeriesLines
Set slsSeriesLines = ActiveChart.ChartGroups(1).SeriesLines

ShowNegativeBubbles True se bolhas negativas forem mostradas para o grupo gráfico. Válida somente para gráficos de bolhas. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).ShowNegativeBubbles = True

SizeRepresents Retorna ou define o que o tamanho da bolha representa em um gráfico de bolhas. Pode ser uma das seguintes constantes XlSizeRepresents : xlSizeIsArea ou xlSizeIsWidth. Long de leitura/gravação.

ActiveChart.ChartGroups(1).SizeRepresents = xlSizeIsArea

SplitType Retorna ou define a maneira como as duas seções de um gráfico pizza de pizza ou de uma barra de pizza são divididas. XlChartSplitType de leitura/gravação.

ActiveChart.ChartGroups(1).SplitType = xlSplitByCustomSplit

SplitValue Retorna ou define o valor de limite que separa as duas seções de uma pizza de gráfico de pizza ou uma barra de gráfico de pizza. de leitura/gravação.

ActiveChart.ChartGroups(1).SplitValue = 10

UpBars Retorna um objeto UpBars que representa as barras superiores em um gráfico de linhas. Aplica-se apenas a gráficos de linhas. Somente leitura.

Dim ubsUpBars As UpBars
Set ubsUpBars = ActiveChart.ChartGroups(1).UpBars

VaryByCategories True se o Microsoft Excel atribui uma cor ou padrão diferente para cada marcador de dados. O gráfico precisa conter somente uma série. Boolean de leitura/gravação.

ActiveChart.ChartGroups(1).VaryByCategories = True

ChartGroups.Count Retorna um valor Long que representa o número de objetos na coleção.

Dim lngCount As Long
lngCount = ActiveChart.ChartGroups.Count

ChartGroups.Parent Retorna o objeto pai do objeto especificado. Somente leitura.

Dim objParent As Object
Set objParent = ActiveChart.ChartGroups.Parent