SeriesCollection.Add method (Excel)

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

Sintaxe

expressão. Adicionar (Origem, Rowcol, SeriesLabels, CategoryLabels, Substituir)

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 Intervalo .
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 este argumento for omitido, o Excel tenta determinar a localização da etiqueta de categoria a partir do conteúdo da primeira linha ou coluna.
Replace	Opcional	Variant	Se CategoryLabels for Verdadeiro e Substituir for Verdadeiro, as categorias especificadas substituem as categorias que existem atualmente para a série. Se Substituir for Falso, 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 no 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.