Objet Graphique (Excel)

Représente un graphique dans un classeur.

Remarques

Il peut s'agir d'un graphique incorporé (contenu dans un objet ChartObject) ou d'une feuille de graphique séparée.

La collection Charts contient un objet Chart pour chaque feuille de graphique figurant dans un classeur. Utilisez Graphiques (Chart) ( index ), où index est le nom ou le numéro d’index de la feuille graphique, pour renvoyer un seul objet Graphique.

Le numéro d'indexgraphique indique la position de la feuille de graphique (chart) dans la barre d'onglets du classeur. Charts(1) correspond au premier graphique du classeur (le plus à gauche) ; Charts(Charts.Count) correspond au dernier graphique (le plus à droite).

Toutes les feuilles de graphique, même masquées, sont incluses dans le compte d'index. Le nom de la feuille de graphique figure sur l'onglet de classeur correspondant. Utilisez la propriété Nom de l'objet ChartObject pour définir ou renvoyer le nom du graphique.

L'exemple suivant modifie la couleur de la série 1 sur la feuille de graphique 1.

Charts(1).SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbRed

L'exemple suivant déplace le graphique nommé Ventes à la fin du classeur actif.

Charts("Sales").Move after:=Sheets(Sheets.Count)

L'objet Chart est également membre de la collection Sheets qui contient toutes les feuilles (feuilles de graphique et feuilles de calcul) du classeur. Pour renvoyer une seule feuille, utilisez Feuilles ( index ), oùindex étant le nom ou le numéro d’index de la feuille.

Lorsqu’un graphique est l’objet actif, vous pouvez utiliser la propriété ActiveChart pour faire référence à celui-ci. Une feuille de graphique est active si l'utilisateur l'a sélectionnée ou si elle a été activée avec la méthode Activerde l’objetGraphiqueou de l’objetActiver de la méthode de l’objetChartObject.

L’exemple suivant active la feuille de graphique (chart)1 puis définit le type de graphique et le titre.

Charts(1).Activate 
With ActiveChart 
 .Type = xlLine 
 .HasTitle = True 
 .ChartTitle.Text = "January Sales" 
End With

Un graphique incorporé est actif si l'utilisateur l'a sélectionné ou si l'objet ChartObject qui le contient a été activé avec la méthode Activate.

L'exemple suivant active le graphique incorporé  1 dans la feuille de calcul 1, puis définit le type et le titre du graphique. Notez qu'après l'activation du graphique incorporé, le code de cet exemple est identique à celui de l'exemple précédent. La propriété ActiveChart vous permet d'écrire un code Visual Basic faisant référence à un graphique incorporé ou à une feuille de graphique (selon leur état d'activation).

Worksheets(1).ChartObjects(1).Activate 
ActiveChart.ChartType = xlLine 
ActiveChart.HasTitle = True 
ActiveChart.ChartTitle.Text = "January Sales"

Lorsqu’une feuille de graphique est la feuille active, vous pouvez utiliser la propriété ActiveSheet pour faire référence à celle-ci. L'exemple suivant utilise la méthode Activate pour activer la feuille de graphique nommée Chart1, puis définit la couleur intérieure bleue pour la série 1 dans le graphique.

Charts("chart1").Activate 
ActiveSheet.SeriesCollection(1).Format.Fill.ForeColor.RGB = rgbBlue

Événements

Méthodes

Propriétés

Voir aussi

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.