Método SeriesCollection.Add (Excel)

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

Sintaxe

expressão. Add (Source, Rowcol, SeriesLabels, CategoryLabels, Replace)

expressão Uma variável que representa um objeto SeriesCollection.

Parâmetros

Nome Obrigatório/Opcional Tipo de dados Descrição
Source Obrigatório Variant Os novos dados como um objeto Range.
Rowcol Opcional XlRowCol Especifica se os novos valores estão nas linhas ou colunas do intervalo especificado.
SeriesLabels Opcional Variant 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 Opcional Variant 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, Excel tentar determinar o local do rótulo de categoria do conteúdo da primeira linha ou coluna.
Replace Opcional Variant Se CategoryLabels for True e Replace for True, as categorias especificadas substituirão as categorias existentes atualmente para a série. Se Replace for False, as categorias existentes não serão substituídas. O valor padrão é False.

Valor de retorno

Um objeto Series que representa a nova série.

Comentários

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.

Exemplo

Este exemplo cria uma nova série em Chart1. A fonte de dados para a nova série é o intervalo B1:B10 de Sheet1.

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

Este exemplo cria uma nova série no gráfico incorporado de Sheet1.

Worksheets("Sheet1").ChartObjects(1).Activate 
ActiveChart.SeriesCollection.Add _ 
 Source:=Worksheets("Sheet1").Range("B1:B10")

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.