Clase Series (Excel VBA)

La clase Series representa una serie de un gráfico.

Los principales procedimientos de la clase Series son Copy, Delete, Select y SeriesCollection.Add

Set

Para usar una variable de clase Series, primero debe ser instanciado, por ejemplo

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

Los siguientes procedimientos se pueden usar para establecer variables de clase Series : Chart.FullSeriesCollection, FullSeriesCollection.Item, SeriesCollection.Item, SeriesCollection.Add, SeriesCollection.NewSeries, Chart.SeriesCollection y ChartGroup.SeriesCollection

For Each

A continuación, se muestra un ejemplo de cómo procesar los elementos Series en una colección.

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

Temas

Algunos procedimientos de esta clase se han agrupado en temas y se describen en páginas temáticas separadas

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

Métodos

Los principales métodos de la clase Series son

Copy - Si la serie tiene un relleno de imagen, este método copia la imagen en el portapapeles.

ActiveChart.FullSeriesCollection(1).Copy

Delete - Elimina el objeto.

ActiveChart.FullSeriesCollection(1).Delete

Select - Selecciona el objeto.

ActiveChart.FullSeriesCollection(1).Select

SeriesCollection.Add - Agrega una o más series nuevas a la colección SeriesCollection .

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

Otros Métodos

FullSeriesCollection.Item - Devuelve un único objeto del objeto FullSeriesCollection .

ApplyDataLabels - Aplica rótulos de datos a una serie.

ClearFormats - Borra el formato del objeto.

DataLabels - Devuelve un objeto Object que representa un único rótulo de datos (un objeto DataLabel ) o una colección de todos los rótulos de datos de la serie (una colección DataLabels ).

ErrorBar - Aplica barras de error a la serie.

Paste - Pega una imagen del Portapapeles como marcador en la serie seleccionada.

Points - Devuelve un objeto Object que representa un solo punto (un objeto Point ) o una colección de todos los puntos ( una colección Points) de la serie. Solo lectura.

SetProperty -

Trendlines - Devuelve un objeto Object que representa una sola línea de tendencia (un objeto Trendline ) o una colección de todas las líneas de tendencia (una colección Trendlines ) para la serie.

SeriesCollection.Extend - Agrega puntos de datos nuevos a una colección de series ya existente.

SeriesCollection.Item - Devuelve un solo objeto de una colección.

SeriesCollection.NewSeries - Crea una nueva serie. Devuelve un objeto series que representa la nueva serie.

SeriesCollection.Paste - Pega los datos del Portapapeles en la colección de series especificada.

Propiedades

FullSeriesCollection.Count Devuelve un valor de tipo Long que representa el número de objetos series en el objeto FullSeriesCollection .

Dim lngCount As Long
lngCount = ActiveChart.FullSeriesCollection.Count

FullSeriesCollection.Parent Devuelve un objeto Object que representa el objeto primario del objeto FullSeriesCollection especificado.

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

ApplyPictToEnd True si una imagen se aplica al final del punto o a todos los puntos de la serie. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).ApplyPictToEnd = True

ApplyPictToFront True si una imagen se aplica a la parte delantera del punto o a todos los puntos de la serie. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).ApplyPictToFront = True

ApplyPictToSides True si una imagen se aplica a los lados del punto o a todos los puntos de la serie. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).ApplyPictToSides = True

AxisGroup Devuelve o establece el grupo de la serie especificada. Lectura y escritura.

ActiveChart.FullSeriesCollection(1).AxisGroup = xlPrimary

BarShape Devuelve o establece la forma utilizada con el gráfico de columnas o de barras 3D. Valor XlBarShape de lectura y escritura.

ActiveChart.FullSeriesCollection(1).BarShape = xlBox

BubbleSizes Devuelve o establece una cadena que hace referencia a las celdas de la hoja de cálculo que contienen el valor x, el valor y y los datos de tamaño del gráfico de burbujas. Cuando se devuelve la referencia de la celda, devolverá una cadena que describe las celdas en notación de estilo A1. Para establecer los datos de tamaño del gráfico de burbujas es necesario utilizar la notación de estilo F1C1. Sólo se aplica a gráficos de burbujas. Variante de lectura y escritura.

ActiveChart.FullSeriesCollection(1).BubbleSizes = 20

ChartType Devuelve o establece el tipo de gráfico. XlChartType de lectura y escritura.

ActiveChart.FullSeriesCollection(1).ChartType = xl3DArea

ErrorBars Devuelve un objeto ErrorBars que representa las barras de error de la serie. Solo lectura.

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

Explosion Devuelve o establece el valor de expansión de un sector del gráfico circular o gráfico de anillos. Devuelve 0 (cero) si no hay expansión (el vértice del sector está en el centro del círculo). Long de lectura y escritura.

ActiveChart.FullSeriesCollection(1).Explosion =

Format Devuelve el objeto ChartFormat . Solo lectura.

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

GeoMappingLevel Especifica el nivel de asignación de geografía de la serie especificada en el grupo de gráficos. XlGeoMappingLevel de lectura y escritura.

ActiveChart.FullSeriesCollection(1).GeoMappingLevel = xlGeoMappingLevelAutomatic

GeoProjectionType Especifica el tipo de proyección de geografía de la serie especificada en el grupo de gráficos. XlGeoProjectionType de lectura y escritura.

ActiveChart.FullSeriesCollection(1).GeoProjectionType = xlGeoProjectionTypeAlbers

Has3DEffect True si la serie tiene aspecto tridimensional. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).Has3DEffect = True

HasDataLabels True si la serie tiene etiqueta de datos. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).HasDataLabels = True

HasErrorBars True si la serie tiene barras de error. Esta propiedad no está disponible para los gráficos 3D. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).HasErrorBars = True

HasLeaderLines True si la serie tiene líneas guía. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).HasLeaderLines = True

InvertColor Devuelve o establece el color de relleno para puntos de datos negativos en una serie. Lectura y escritura.

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

InvertColorIndex Devuelve o establece el color de relleno para puntos de datos negativos en una serie. Lectura y escritura.

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

InvertIfNegative True si Microsoft Excel invierte el diseño del elemento cuando éste corresponde a un número negativo. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).InvertIfNegative = True

IsFiltered Esta configuración controla si la serie se ha filtrado del gráfico. El valor predeterminado es False. Boolean de lectura y escritura.

ActiveChart.FullSeriesCollection(1).IsFiltered = True

LeaderLines Devuelve un objeto LeaderLines que representa las líneas guía de la serie. Solo lectura.

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

MarkerBackgroundColor Establece el color de fondo del marcador como un valor RGB o devuelve el valor de índice de color correspondiente. Se aplica únicamente a los gráficos de líneas, de dispersión y radiales. Long de lectura y escritura.

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

MarkerBackgroundColorIndex Devuelve o establece el color de fondo del marcador como un índice para la paleta de colores activa o bien como una de las siguientes constantes XlColorIndex: xlColorIndexAutomatic o xlColorIndexNone. Se aplica sólo a los gráficos de líneas, dispersión y radiales. Long de lectura y escritura.

ActiveChart.FullSeriesCollection(1).MarkerBackgroundColorIndex = xlColorIndexAutomatic

MarkerForegroundColor Establece el color de primer plano del marcador como un valor RGB o devuelve el valor del índice de color correspondiente. Se aplica únicamente a los gráficos de líneas, de dispersión y radiales. Long de lectura y escritura.

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

MarkerForegroundColorIndex Devuelve o establece el color de primer plano del marcador como un índice para la paleta de colores activa o bien como una de las siguientes constantes XlColorIndex: xlColorIndexAutomatic o xlColorIndexNone. Se aplica sólo a los gráficos de líneas, dispersión y radiales. Long de lectura y escritura.

ActiveChart.FullSeriesCollection(1).MarkerForegroundColorIndex = xlColorIndexAutomatic

MarkerSize Devuelve o establece el tamaño de los marcadores de datos, en puntos. Puede ser cualquier valor comprendido entre 2 y 72. Long de lectura y escritura.

ActiveChart.FullSeriesCollection(1).MarkerSize =

MarkerStyle Devuelve o establece el estilo del marcador de un punto o una serie en un gráfico de líneas, de dispersión o radial. XlMarkerStyle de lectura y escritura.

ActiveChart.FullSeriesCollection(1).MarkerStyle = xlMarkerStyleAutomatic

Name Devuelve o establece un valor de tipo String que representa el nombre del objeto.

ActiveChart.FullSeriesCollection(1).Name =

Parent Devuelve el objeto primario del objeto especificado. Solo lectura.

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

ParentDataLabelOption Especifica la opción de etiqueta de datos principal (mensaje emergente, superpuesta o ninguna) de la serie especificada en el grupo de gráficos. XlParentDataLabelOptions de lectura y escritura.

ActiveChart.FullSeriesCollection(1).ParentDataLabelOption = xlParentDataLabelOptionsBanner

PictureType Devuelve o establece un valor XlChartPictureType que representa el modo en que se muestran las imágenes en un gráfico de imágenes de barras o columnas.

ActiveChart.FullSeriesCollection(1).PictureType = xlStack

PictureUnit2 Devuelve o establece la unidad de cada imagen del gráfico si la propiedad PictureType es el valor xlStackScale (de lo contrario, esta propiedad se omite). Double de lectura y escritura.

ActiveChart.FullSeriesCollection(1).PictureUnit2 =

PlotColorIndex Devuelve un valor de índice que se usa internamente para asociar el formato de serie con los elementos del gráfico. Solo lectura.

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

PlotOrder Devuelve o establece el orden de trazado de la serie seleccionada en el grupo de gráficos. Long de lectura y escritura.

ActiveChart.FullSeriesCollection(1).PlotOrder = 3

QuartileCalculationInclusiveMedian True si la serie usa un método de cálculo de cuartil de mediana inclusiva. Boolean de lectura y escritura.

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 Devuelve o establece un valor de tipo Boolean que determina si el objeto tiene una sombra.

ActiveChart.FullSeriesCollection(1).Shadow = True

Smooth True si el suavizado de curvas está activado para el gráfico de líneas o de dispersión. Se aplica únicamente a los gráficos de líneas y de dispersión. Lectura y escritura.

ActiveChart.FullSeriesCollection(1).Smooth = True

Type Devuelve o establece un valor de tipo Long que representa el tipo de serie.

ActiveChart.FullSeriesCollection(1).Type =

ValueSortOrder

ActiveChart.FullSeriesCollection(1).ValueSortOrder = xlValueAscending

SeriesCollection.Count Devuelve un valor Long que representa el número de objetos de la colección.

Dim lngCount As Long
lngCount = ActiveChart.SeriesCollection.Count

SeriesCollection.Parent Devuelve el objeto primario del objeto especificado. Solo lectura.

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