Classe SeriesCollection (Excel VBA)

Collection de tous les objets Series du graphique ou du groupe de graphiques spécifié.

Pour utiliser une variable de classe SeriesCollection, elle doit d'abord être instanciée, par exemple

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

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe SeriesCollection : Chart.SeriesCollection et ChartGroup.SeriesCollection.

Add

Ajoute une ou plusieurs nouvelles séries à la collection SeriesCollection .

Cette méthode ne retourne pas réellement un objet Series comme indiqué dans l'Explorateur d'objets. Cette méthode n'est pas disponible pour les rapports de graphique croisé dynamique.

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

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

Arguments

Un argument nommé

Source (Range) - Nouvelles données sous la forme d’un objet Range .

Optional arguments

Les arguments suivants sont facultatifs

Rowcol (XlRowCol) - Spécifie si les nouvelles valeurs sont dans les lignes ou colonnes de la plage spécifiée.

Les valeurs de retour possibles sont xlColumns - Les séries de données sont disposées en ligne, xlRows - Les séries de données sont disposées en colonne.

SeriesLabels (Boolean) - True si la première ligne ou colonne contient le nom de la série de données. Faux si la première ligne ou colonne contient le premier point de données de la série. Si cet argument est omis, Microsoft Excel tente de déterminer l’emplacement du nom de série à partir du contenu de la première ligne ou colonne.

CategoryLabels (Boolean) - True si la première ligne ou colonne contient le nom des étiquettes de catégorie. False si la première ligne ou colonne contient le premier point de données de la série. Si vous ne spécifiez pas cet argument, Excel tente de déterminer l’emplacement de l’étiquette de catégorie à partir du contenu de la première ligne ou colonne.

Replace (Boolean) - Si CategoryLabels a la valeur true et remplacer la valeur true, les catégories spécifiées remplacent les catégories qui existent actuellement pour la série. Si Replace a la valeur false, les catégories existantes ne seront pas remplacées. La valeur par défaut est False.

Count

Cette propriété renvoie une valeur de type Long qui représente le nombre d’objets de la collection.

Dim lngCount As Long
lngCount = ActiveChart.SeriesCollection.Count

Extend

Cette méthode ajoute de nouveaux points de données à une collection de séries existante.

Cette méthode n'est pas disponible pour les rapports de graphique croisé dynamique.

Extend (Source, Rowcol, CategoryLabels)

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

Arguments

Un argument nommé

Source (Range) - Les nouvelles données à ajouter à l’objet SeriesCollection en tant qu’objet Range .

Optional arguments

Les arguments suivants sont facultatifs

Rowcol (XlRowCol) - Spécifie si les nouvelles valeurs se situent dans les lignes ou dans les colonnes de la plage source indiquée. Peut être une des constantes XlRowCol suivantes : xlRows ou xlColumns. Si vous ne spécifiez pas cet argument, Microsoft Excel tente de déterminer l'emplacement des valeurs en fonction de la taille et de l'orientation de la plage sélectionnée ou des dimensions du tableau.

Les valeurs de retour possibles sont xlColumns - Les séries de données sont disposées en ligne, xlRows - Les séries de données sont disposées en colonne.

CategoryLabels (Boolean) - True pour que la première ligne ou colonne contient le nom des étiquettes de catégorie. False pour que la première ligne ou colonne contient le premier point de données de la série. Si vous ne spécifiez pas cet argument, Excel tente de déterminer l’emplacement de l’étiquette de catégorie à partir du contenu de la première ligne ou colonne.

Item

Cette méthode renvoie un seul objet d'une collection.

Item (Index)

Index: Nom ou numéro d'index de l'objet.

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

NewSeries

Créer une nouvelle série. Renvoie un objet Series qui représente la nouvelle série.

Cette méthode n'est pas disponible pour les rapports de graphique croisé dynamique.

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

Paste

Cette méthode colle les données provenant du Presse-papiers dans la collection de séries spécifiée.

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

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

Arguments

Optional arguments

Les arguments suivants sont facultatifs

Rowcol (XlRowCol) - Indique si les valeurs correspondant à une série de données particulière sont disposées en lignes ou en colonnes.

Les valeurs de retour possibles sont xlColumns - Les séries de données sont disposées en ligne, xlRows - Les séries de données sont disposées en colonne.

SeriesLabels (Boolean) - True pour utiliser le contenu de la cellule de la première colonne de chaque ligne (ou de la première ligne de chaque colonne) comme nom de la série de données de cette ligne (ou de cette colonne). Falsepour utiliser le contenu de la cellule de la première colonne de chaque ligne (ou de la première ligne de chaque colonne) comme premier point de données de la série de données. La valeur par défaut est False.

CategoryLabels (Boolean) - True pour utiliser le contenu de la première ligne (ou colonne) de la sélection comme abscisses du graphique. False pour utiliser le contenu de la première ligne (ou colonne) comme première série de données du graphique. La valeur par défaut est False.

Replace (Boolean) - True pour appliquer les abscisses lors du remplacement des abscisses existantes par les données de la plage copiée. False pour insérer de nouvelles abscisses sans remplacer les anciennes. La valeur par défaut est True.

NewSeries (Boolean) - True pour coller les données en tant que nouvelle série. False pour coller les données en tant que nouveaux points dans une série existante. La valeur par défaut est True.