Clase SeriesCollection (Excel VBA)

Colección de todos los objetos series en el gráfico o grupo de gráficos especificado.

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

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

Los siguientes procedimientos se pueden usar para establecer variables de clase SeriesCollection : Chart.SeriesCollection y ChartGroup.SeriesCollection.

Add

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

Este método no devuelve realmente un objeto Series como se indica en el Examinador de objetos. Este método no está disponible para informes de gráfico dinámico.

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

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

Arguments

Un argumento con nombre

Source (Range) - Los nuevos datos como un objeto Range .

Optional arguments

Los siguientes argumentos son opcionales

Rowcol (XlRowCol) - Especifica si los nuevos valores están en las filas o columnas del rango especificado.

Posibles valores de retorno son xlColumns - La serie de datos está en una fila, xlRows - La serie de datos está en una columna.

SeriesLabels (Boolean) - True si la primera fila o columna contiene el nombre de la serie de datos. False si la primera fila o columna contiene el primer punto de datos de la serie. Si se omite este argumento, Microsoft Excel intenta determinar la ubicación del nombre de la serie según el contenido de la primera fila o columna.

CategoryLabels (Boolean) - True si la primera fila o columna contiene el nombre de los rótulos de categorías. False si la primera fila o columna contiene el primer punto de datos de la serie. Si se omite este argumento, Excel intenta determinar la ubicación de la etiqueta de categoría a partir del contenido de la primera fila o columna.

Replace (Boolean) - Si CategoryLabels es true y Replace es true, las categorías especificadas reemplazarán las categorías que existen actualmente para la serie. Si Replace es false, no se reemplazarán las categorías existentes. El valor predeterminado es False.

Count

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

Dim lngCount As Long
lngCount = ActiveChart.SeriesCollection.Count

Extend

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

Este método no está disponible para informes de gráfico dinámico.

Extend (Source, Rowcol, CategoryLabels)

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

Arguments

Un argumento con nombre

Source (Range) - Los nuevos datos que se van a agregar al objeto SeriesCollection como un objeto Range .

Optional arguments

Los siguientes argumentos son opcionales

Rowcol (XlRowCol) - Especifica si los nuevos valores están en las filas o en las columnas del origen de rango especificado. Puede ser una de las siguientes constantes XlRowCol: xlRows o xlColumns. Si este argumento se omite, Microsoft Excel intentará determinar dónde se encuentran los valores basándose en el tamaño y la orientación del rango seleccionado o en las dimensiones de la matriz.

Posibles valores de retorno son xlColumns - La serie de datos está en una fila, xlRows - La serie de datos está en una columna.

CategoryLabels (Boolean) - True para que la primera fila o columna contenga el nombre de los rótulos de categorías. False para que la primera fila o columna contengan el primer punto de datos de la serie. Si se omite este argumento, Excel intenta determinar la ubicación de la etiqueta de categoría a partir del contenido de la primera fila o columna.

Item

Devuelve un solo objeto de una colección.

Item (Index)

Index: Número de índice o nombre del objeto.

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

NewSeries

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

Este método no está disponible para los informes de gráfico dinámico.

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

Paste

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

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

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

Arguments

Optional arguments

Los siguientes argumentos son opcionales

Rowcol (XlRowCol) - Especifica si los valores correspondientes a una serie de datos determinada están en filas o en columnas.

Posibles valores de retorno son xlColumns - La serie de datos está en una fila, xlRows - La serie de datos está en una columna.

SeriesLabels (Boolean) - Si es True, se usa el contenido de la celda de la primera columna de cada fila (o de la primera fila de cada columna) como nombre de la serie de datos de dicha fila (o columna). Si es False, se usa el contenido de la celda de la primera columna de cada fila (o de la primera fila de cada columna) como primer punto de datos de la serie de datos. El valor predeterminado es False.

CategoryLabels (Boolean) - Si es True, se usa el contenido de la primera fila (o columna) de la selección como categorías del gráfico. Si es False, se usa el contenido de la primera fila (o columna) como primera serie de datos del gráfico. El valor predeterminado es False.

Replace (Boolean) - Si es True, se aplican las categorías mientras se reemplazan las categorías existentes con información procedente del rango copiado. Si es False, se insertan nuevas categorías sin reemplazar a las anteriores. El valor predeterminado es True.

NewSeries (Boolean) - Si es True, se pegan los datos como una serie nueva. Si es False, se pegan los datos como puntos nuevos de una serie ya existente. El valor predeterminado es True.