Classe SeriesCollection (Word VBA)

La classe SeriesCollection représente une 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 = ActiveDocument.Background.Chart.SeriesCollection()

Add

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

Cette méthode ne renvoie pas réellement un objetsérie comme indiqué dans l’Explorateur d’objets.

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

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 .Chart.SeriesCollection.Add _ 
 Source:="Sheet1!B1:B10" 
 End If 
End With

Arguments

Un argument nommé

Source (Source) - Nouvelles données en tant que représentation sous forme de chaîne d'une plage contenue dans la propriété Workbook de l'objet ChartData du graphique.

Optional arguments

Les arguments suivants sont facultatifs

Rowcol (XlRowCol) - L'une des valeurs de l'énumération qui indique si les nouvelles valeurs se trouvent dans les lignes ou les colonnes de la plage spécifiée.

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

SeriesLabels (Boolean) - True si la première ligne ou colonne contient le nom de la série de données.

CategoryLabels (Boolean) - True si la première ligne ou colonne contient le nom des étiquettes de catégorie.

Replace (Boolean) - Si CategoryLabels et Replace a la valeur True, les catégories spécifiées remplacent les catégories qui existent actuellement pour la série.

Count

Renvoie le nombre d'objets dans la collection.

Dim lngCount As Long
lngCount = ActiveDocument.Background.Chart.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)

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 .Chart.SeriesCollection.Extend _ 
 Source:="B1:B6" 
 End If 
End With

Arguments

Un argument nommé

Source (Source) - Les nouvelles données à ajouter à l'objet SeriesCollection, représenté sous la forme d'une référence de plage de style A1.

Optional arguments

Les arguments suivants sont facultatifs

Rowcol (XlRowCol) - L'une des valeurs de l'énumération XlRowCol qui spécifie si les nouvelles valeurs se trouvent dans les lignes ou les colonnes de la plage source donnée.

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

CategoryLabels (Boolean) - True pour que la première ligne ou colonne contient le nom des étiquettes de catégorie.

Item

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

Item (Index)

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

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 With .Chart.SeriesCollection.Item(1).Trendlines.Item(1) 
 .Forward = 5 
 .Backward = .5 
 End With 
 End If 
End With 

NewSeries

Cette méthode crée une nouvelle série.

Cette méthode n’est pas disponible pour les graphiques croisés dynamiques.

With ActiveDocument.InlineShapes(1) 
 If .HasChart Then 
 Set ns = .Chart.SeriesCollection.NewSeries 
 End If 
End With