Classe Series (Excel VBA)

A classe Series representa uma série de um gráfico.

Os principais procedimentos da classe Series são Copy, Delete, Select e SeriesCollection.Add

Set

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

Dim srs as Series
Set srs = ActiveChart.FullSeriesCollection(Index:=1)

Os procedimentos a seguir podem ser usados ​​para definir variáveis ​​do tipo Series: Chart.FullSeriesCollection, FullSeriesCollection.Item, SeriesCollection.Item, SeriesCollection.Add, SeriesCollection.NewSeries, Chart.SeriesCollection e ChartGroup.SeriesCollection

For Each

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

Dim srsFullSeriesCollection As Series
For Each srsFullSeriesCollection In ActiveChart.FullSeriesCollection()
	
Next srsFullSeriesCollection

Temas

Alguns procedimentos nesta classe foram agrupados em temas e são descritos em páginas de tema separadas

Formula with its procedures Formula, FormulaLocal, FormulaR1C1 e FormulaR1C1Local
Value with its procedures Values e XValues

Métodos

Estes são os principais métodos da classe Series

Copy - Se a série tiver um preenchimento de imagem, este método copiará a imagem para a área de transferência.

ActiveChart.FullSeriesCollection(1).Copy

Delete - Exclui o objeto.

ActiveChart.FullSeriesCollection(1).Delete

Select - Seleciona o objeto.

ActiveChart.FullSeriesCollection(1).Select

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

Dim srs As Series
Set srs = ActiveChart.SeriesCollection.Add(Source:=)

Estes são os principais métodos da classe

FullSeriesCollection.Item - Retorna um único objeto do objeto FullSeriesCollection .

ApplyDataLabels - Aplica rótulos de dados a uma série.

ClearFormats - Limpa a formatação do objeto.

DataLabels - Retorna um objeto que representa um único rótulo de dados um objeto DataLabel ou uma coleção de todos os rótulos de dados da série (uma coleção DataLabels ).

ErrorBar - Aplica barras de erro à série.

Paste - Cola uma imagem da Área de Transferência como marcador na série selecionada.

Points - Retorna um objeto que representa um único ponto um objeto Point ou uma coleção de todos os pontos (uma coleção Points ) na série. Somente leitura.

Trendlines - Retorna um objeto que representa uma única tendência um objeto Trendline ou uma coleção de todas as linhas de tendência (uma coleção Trendlines ) para a série.

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

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

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

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

Propriedades

FullSeriesCollection.Count Retorna um valor Long que representa o número de objetos Series no objeto FullSeriesCollection . Somente leitura.

Dim lngCount As Long
lngCount = ActiveChart.FullSeriesCollection.Count

FullSeriesCollection.Parent Retorna um objeto que representa o objeto pai do objeto FullSeriesCollection especificado. Somente leitura.

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

ApplyPictToEnd True se uma figura for aplicada ao final do ponto ou de todos os pontos na série. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).ApplyPictToEnd = True

ApplyPictToFront True se uma figura for aplicada à frente do ponto ou de todos os pontos na série. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).ApplyPictToFront = True

ApplyPictToSides True se uma figura for aplicada aos lados do ponto ou de todos os pontos na série. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).ApplyPictToSides = True

AxisGroup Retorna ou define o grupo da série especificada. Leitura/gravação.

ActiveChart.FullSeriesCollection(1).AxisGroup = xlPrimary

BarShape Retorna ou define a forma usada com o gráfico de colunas ou barra 3D. XlBarShape de leitura/gravação.

ActiveChart.FullSeriesCollection(1).BarShape = xlBox

BubbleSizes Retorna ou define uma cadeia de caracteres que se refere às células da planilha contendo o valor x, y-Value e os dados de tamanho do gráfico de bolhas. Quando você retorna a referência da célula, ela retornará uma cadeia descrevendo as células na notação de estilo A1. Para definir os dados do tamanho do gráfico de bolhas, é necessário usar a notação do estilo R1C1. Só se aplica a gráficos de bolhas. de leitura/gravação.

ActiveChart.FullSeriesCollection(1).BubbleSizes = 20

ChartType Retorna ou define o tipo de gráfico. XlChartType de leitura/gravação.

ActiveChart.FullSeriesCollection(1).ChartType = xl3DArea

ErrorBars Retorna um objeto ErrorBars que representa as barras de erro da série. Somente leitura.

Dim ebsErrorBars As ErrorBars
Set ebsErrorBars = ActiveChart.FullSeriesCollection(1).ErrorBars

Explosion Retorna ou define o valor de explosão para um gráfico de pizza ou fatia de gráfico de rosca. Retorna 0 zero se não houver explosão (a ponta da fatia está no centro da pizza). Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Explosion =

Format Retorna o objeto ChartFormat . Somente leitura.

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveChart.FullSeriesCollection(1).Format

GeoMappingLevel Especifica o nível de mapeamento de Geografia para a série especificada dentro do grupo de gráficos. Leitura/gravação XlGeoMappingLevel.

ActiveChart.FullSeriesCollection(1).GeoMappingLevel = xlGeoMappingLevelAutomatic

GeoProjectionType Especifica o tipo de projeção de Geografia para a série especificada dentro do grupo de gráficos. Leitura/gravação XlGeoProjectionType.

ActiveChart.FullSeriesCollection(1).GeoProjectionType = xlGeoProjectionTypeAlbers

Has3DEffect True se a série possuir uma aparência tridimensional. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).Has3DEffect = True

HasDataLabels True se a série tiver rótulos de dados. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).HasDataLabels = True

HasErrorBars True se a série tiver barras de erro. Esta propriedade não está disponível para gráficos 3D. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).HasErrorBars = True

HasLeaderLines True se a série tiver linhas de preenchimento. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).HasLeaderLines = True

InvertColor Retorna ou define a cor de preenchimento para pontos de dados negativos de uma série. Leitura/gravação.

ActiveChart.FullSeriesCollection(1).InvertColor = RGB(0,0,255)'blue

InvertColorIndex Retorna ou define a cor de preenchimento para pontos de dados negativos de uma série. Leitura/gravação.

ActiveChart.FullSeriesCollection(1).InvertColorIndex = RGB(0,0,255)'blue

InvertIfNegative True se o Microsoft Excel inverte o padrão no item quando ele corresponde a um número negativo. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).InvertIfNegative = True

IsFiltered Esta configuração controla se a série foi filtrada no gráfico. O valor padrão é False. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).IsFiltered = True

LeaderLines Retorna um objeto LeaderLines que representa as linhas de preenchimento para a série. Somente leitura.

Dim llsLeaderLines As LeaderLines
Set llsLeaderLines = ActiveChart.FullSeriesCollection(1).LeaderLines

MarkerBackgroundColor Define a cor de plano de fundo do marcador como um valor RGB ou retorna o valor de índice de cor correspondente. Só se aplica a gráficos de linhas, de dispersão e de radar. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerBackgroundColor = RGB(0,0,255)'blue

MarkerBackgroundColorIndex Retorna ou define a cor de plano de fundo do marcador como um índice na paleta de cores atual ou como uma das seguintes constantes XlColorIndex: xlColorIndexAutomatic ou xlColorIndexNone. Só se aplica a gráficos de linhas, de dispersão e de radar. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerBackgroundColorIndex = xlColorIndexAutomatic

MarkerForegroundColor Define a cor de primeiro plano do marcador como um valor RGB ou retorna o valor de índice de cor correspondente. Só se aplica a gráficos de linhas, de dispersão e de radar. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerForegroundColor = RGB(0,0,255)'blue

MarkerForegroundColorIndex Retorna ou define a cor de primeiro plano do marcador como um índice na paleta de cores atual ou como uma das seguintes constantes XlColorIndex: xlColorIndexAutomatic ou xlColorIndexNone. Só se aplica a gráficos de linhas, de dispersão e de radar. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerForegroundColorIndex = xlColorIndexAutomatic

MarkerSize Retorna ou define o tamanho do marcador de dados, em pontos. Pode ser um valor de 2 a 72. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerSize =

MarkerStyle Retorna ou define o estilo de marcador para um ponto ou uma série em um gráfico de linhas, de dispersão ou de radar. XlMarkerStyle de leitura/gravação.

ActiveChart.FullSeriesCollection(1).MarkerStyle = xlMarkerStyleAutomatic

Name Retorna ou define um valor String que representa o nome do objeto.

ActiveChart.FullSeriesCollection(1).Name =

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

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

ParentDataLabelOption Especifica a opção de rótulo de dados pai faixa, sobreposição ou nenhum para a série especificada no grupo de gráficos. Leitura/gravação XlParentDataLabelOptions.

ActiveChart.FullSeriesCollection(1).ParentDataLabelOption = xlParentDataLabelOptionsBanner

PictureType Retorna ou define um valor XlChartPictureType que representa a maneira como as imagens são exibidas em um gráfico de imagem de barra ou coluna.

ActiveChart.FullSeriesCollection(1).PictureType = xlStack

PictureUnit2 Retorna ou define a unidade de cada figura no gráfico se a propriedade PictureType for definida como xlStackScale caso contrário, essa propriedade será ignorada. Double de leitura/gravação.

ActiveChart.FullSeriesCollection(1).PictureUnit2 =

PlotColorIndex Retorna um valor de índice que é usado internamente para associar a formatação de séries a elementos de gráficos. Somente leitura.

Dim lngPlotColorIndex As Long
lngPlotColorIndex = ActiveChart.FullSeriesCollection(1).PlotColorIndex

PlotOrder Retorna ou define a ordem de plotagem para a série selecionada dentro do grupo gráfico. Long de leitura/gravação.

ActiveChart.FullSeriesCollection(1).PlotOrder = 3

QuartileCalculationInclusiveMedian True se a série usar um método de cálculo médio de quartil inclusivo. Boolean de leitura/gravação.

ActiveChart.FullSeriesCollection(1).QuartileCalculationInclusiveMedian = True

RegionLabelOption

ActiveChart.FullSeriesCollection(1).RegionLabelOption = xlRegionLabelOptionsBestFitOnly

SeriesColorGradientStyle

ActiveChart.FullSeriesCollection(1).SeriesColorGradientStyle = xlSeriesColorGradientStyleDiverging

SeriesColorMaxGradientStop

Dim csgSeriesColorMaxGradientStop As ChartSeriesGradientStopData
Set csgSeriesColorMaxGradientStop = ActiveChart.FullSeriesCollection(1).SeriesColorMaxGradientStop

SeriesColorMidGradientStop

Dim csgSeriesColorMidGradientStop As ChartSeriesGradientStopData
Set csgSeriesColorMidGradientStop = ActiveChart.FullSeriesCollection(1).SeriesColorMidGradientStop

SeriesColorMinGradientStop

Dim csgSeriesColorMinGradientStop As ChartSeriesGradientStopData
Set csgSeriesColorMinGradientStop = ActiveChart.FullSeriesCollection(1).SeriesColorMinGradientStop

Shadow Retorna ou define um valor Boolean que determina se o objeto possuirá uma sombra.

ActiveChart.FullSeriesCollection(1).Shadow = True

Smooth True se a suavização de curvas estiver ativada para o gráfico de linhas ou gráfico de dispersão. Só se aplica a gráficos de linhas e de dispersão. Leitura/gravação.

ActiveChart.FullSeriesCollection(1).Smooth = True

Type Retorna ou define um valor Long que representa o tipo de série.

ActiveChart.FullSeriesCollection(1).Type =

ValueSortOrder

ActiveChart.FullSeriesCollection(1).ValueSortOrder = xlValueAscending

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

Dim lngCount As Long
lngCount = ActiveChart.SeriesCollection.Count

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

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