Classe SeriesCollection (Excel VBA)

Uma coleção de todos os objetos Series no gráfico ou no grupo de gráficos especificado. Para usar uma variável de classe SeriesCollection, ela primeiro precisa ser instanciada por exemplo


Dim scn as SeriesCollection
Set scn = ActiveChart.SeriesCollection()

Add

Adiciona uma ou mais séries novas à coleção SeriesCollection.

Este método não retorna um objeto Series conforme mencionado no Pesquisador de objetos. Este método não está disponível para relatórios de gráfico dinâmico.

Add (Source, Rowcol, SeriesLabels, CategoryLabels, Replace)


Charts("Chart1").SeriesCollection.Add Source:=ActiveWorkbook.Worksheets("Sheet1").Range("B1:B10")

Arguments

O seguinte argumento é necessário

Source (Range) - Os novos dados como um objeto Range .

Optional arguments

Os seguintes argumentos são opcionais

Rowcol (XlRowCol) - Especifica se os novos valores estão nas linhas ou colunas do intervalo especificado.

Os valores de retorno possíveis são xlColumns - A série de dados está em uma linha, xlRows - A série de dados está em uma coluna.

SeriesLabels (Boolean) - True se a primeira linha ou coluna contém o nome da série de dados. False se a primeira linha ou coluna contiver o primeiro ponto de dados da série. Se este argumento for omitido, o Microsoft Excel tentará determinar o local do nome de série a partir do conteúdo da primeira linha ou coluna.

CategoryLabels (Boolean) - True se a primeira linha ou coluna contém o nome dos rótulos de categoria. False se a primeira linha ou coluna contiver o primeiro ponto de dados da série. Se esse argumento for omitido, o Excel tentará determinar o local do rótulo de categoria a partir do conteúdo da primeira linha ou coluna.

Replace (Boolean) - Se CategoryLabels for true e replace for true, as categorias especificadas substituirão as categorias que existem atualmente para a série. Se replace for false, as categorias existentes não serão substituídas. O valor padrão é False.

Count

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


Dim lngCount As Long
lngCount = ActiveChart.SeriesCollection.Count

Extend

Adiciona novos pontos de dados à coleção de sequências existente.

Este método não está disponível para relatórios de gráfico dinâmico.

Extend (Source, Rowcol, CategoryLabels)


Charts("Chart1").SeriesCollection.Extend Source:=Worksheets("Sheet1").Range("B1:B6")

Arguments

O seguinte argumento é necessário

Source (Range) - Os novos dados a serem adicionados ao objeto SeriesCollection como um objeto Range .

Optional arguments

Os seguintes argumentos são opcionais

Rowcol (XlRowCol) - Especifica se os novos valores estão nas linhas ou colunas de uma determinada fonte do intervalo. Pode ser uma das seguintes constantes XlRowCol: xlRows ou xlColumns. Se esse argumento for omitido, o Microsoft Excel tentará determinar onde os valores estão pelo tamanho e orientação do intervalo selecionado ou pelas dimensões da matriz.

Os valores de retorno possíveis são xlColumns - A série de dados está em uma linha, xlRows - A série de dados está em uma coluna.

CategoryLabels (Boolean) - True para que a primeira linha ou coluna contenha o nome dos rótulos de categoria. False para que a primeira linha ou coluna contenha o primeiro ponto de dados da série. Se esse argumento for omitido, o Excel tentará determinar o local do rótulo de categoria a partir do conteúdo da primeira linha ou coluna.

Item

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

Item (Index)

Index: O nome ou número de índice do objeto.


Dim srsSeriesCollection As Series
Set srsSeriesCollection = ActiveChart.SeriesCollection(Index:=1)

NewSeries

Cria uma nova série. Retorna um objeto Series que representa a nova série.

Este método não está disponível para relatórios de gráfico dinâmico.


Dim srsNewSeries As Series
Set srsNewSeries = ActiveChart.SeriesCollection.NewSeries()

Paste

Cola dados da Área de Transferência na coleção de séries especificada.

Paste (Rowcol, SeriesLabels, CategoryLabels, Replace, NewSeries)


Worksheets("Sheet1").Range("C1:C5").Copy 
Charts("Chart1").SeriesCollection.Paste

Arguments

Optional arguments

Os seguintes argumentos são opcionais

Rowcol (XlRowCol) - Especifica se os valores correspondentes a uma determinada série de dados estão em linhas ou colunas.

Os valores de retorno possíveis são xlColumns - A série de dados está em uma linha, xlRows - A série de dados está em uma coluna.

SeriesLabels (Boolean) - True para usar o conteúdo da célula na primeira coluna de cada linha (ou na primeira linha de cada coluna) como o nome da série de dados dessa linha (ou coluna). False para usar o conteúdo da célula na primeira coluna de cada linha (ou na primeira linha de cada coluna) como o primeiro ponto de dados na série de dados. O valor padrão é False.

CategoryLabels (Boolean) - True para usar o conteúdo da primeira linha (ou coluna) da seleção como as categorias do gráfico. False para usar o conteúdo da primeira linha (ou coluna) como a primeira série de dados no gráfico. O valor padrão é False.

Replace (Boolean) - True para aplicar categorias ao substituir categorias existentes pelas informações do intervalo copiado. False para inserir novas categorias sem substituir as antigas. O valor padrão é True.

NewSeries (Boolean) - True para colar os dados como uma nova série. False para colar os dados como novos pontos em uma série existente. O valor padrão é True.