Classe Chart (Excel VBA)

La classe Chart représente un graphique dans un classeur.

Les classes suivantes donnent accès à la classe Chart

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

Dim chr as Chart
Set chr = ActiveChart

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe Chart : Application.ActiveChart, Location, ChartObject.Chart, Shape.Chart, ShapeRange.Chart, Sheets.Add, Sheets.Item, Sheets.Visible, Window.ActiveChart et Workbook.ActiveChart.

For Each

Voici un exemple de traitement des éléments Chart dans une collection

Dim chr As Chart
For Each chr In Charts
	
Next chr

Méthodes

Activate -

ApplyChartTemplate - Applique un type de graphique standard ou personnalisé à un graphique.

ApplyDataLabels - Cette méthode applique des étiquettes de données à toutes les séries d’un graphique.

ApplyLayout - Cette méthode applique les mises en page proposées dans le Ruban.

Axes - Renvoie un objet représentant soit un axe unique, soit une collection d'axes du graphique.

ChartGroups - Renvoie un objet qui représente soit un seul groupe de graphiques (un objet ChartGroup ), soit une collection de tous les groupes de graphiques dans le graphique (un objet ChartGroups ). La collection renvoyée inclut tous les types de groupes.

ChartObjects - Renvoie un objet qui représente soit un seul graphique incorporé (un objet ChartObject ), soit une collection de tous les graphiques incorporés (un objet ChartObjects ) de la feuille.

ChartWizard - Cette méthode modifie les propriétés d'un graphique déterminé. Vous pouvez utiliser cette méthode pour mettre rapidement en forme un graphique sans définir individuellement toutes ses propriétés. Cette méthode n'est pas interactive et elle modifie uniquement les propriétés spécifiées.

CheckSpelling - Vérifie l'orthographe d'un objet.

ClearToMatchColorStyle - Cette méthode efface toutes les couleurs du graphique spécifié qui ne suivent pas le style de couleur appliqué au graphique.

ClearToMatchStyle - Cette méthode redéfinit la mise en forme automatique des éléments de graphique.

Copy - Copie la feuille vers un autre emplacement du classeur.

CopyPicture - Cette méthode copie l'objet sélectionné dans le Presse-papiers en tant qu'image.

Delete - Cette méthode supprime l'objet.

Evaluate - Cette méthode convertit un nom Microsoft Excel en un objet ou une valeur.

Export - Exporte le graphique dans un format de graphique.

ExportAsFixedFormat - Cette méthode réalise une exportation dans un fichier avec le format spécifié.

FullSeriesCollection - Permet de récupérer la série filtrée spécifiée par l'argument index .

GetChartElement - Renvoie des informations sur l'élément de graphique aux coordonnées x et y spécifiées. Cette méthode est particulière en ce sens que vous ne spécifiez que les valeurs des deux premiers arguments. Microsoft Excel complète les autres arguments et c'est votre code qui examine ces valeurs lorsque la méthode renvoie son résultat.

GetProperty -

Location - Déplace le graphique vers un nouvel emplacement.

Move - Cette méthode déplace le graphique à un autre emplacement du classeur.

OLEObjects - Renvoie un objet qui représente soit un seul objet OLE ( OLEObject), soit une collection de tous les objets OLE (une collection OLEObjects ) sur le graphique ou la feuille. En lecture seule.

Paste - Colle les données du graphique à partir du Presse-papiers dans le graphique spécifié.

PrintOut - Cette méthode imprime l'objet.

PrintPreview - Cette méthode affiche un aperçu de l'objet tel qu'il apparaîtra une fois imprimé.

Protect - Protège un graphique afin qu’il ne puisse pas être modifié.

Refresh - Cette méthode redessine immédiatement le graphique spécifié.

SaveAs - Cette méthode enregistre dans un autre fichier les modifications effectuées sur le graphique ou la feuille de calcul.

SaveChartTemplate - Enregistre un modèle de graphique personnalisé dans la liste des modèles de graphique disponibles.

Select -

SeriesCollection - Renvoie un objet qui représente soit une seule série (un objet Series ), soit une collection de toutes les séries (une collection SeriesCollection ) dans le graphique ou le groupe de graphiques.

SetBackgroundPicture - Cette méthode définit le graphique de l'arrière-plan d'un graphique.

SetDefaultChart - Cette énumération spécifie le nom du modèle de graphique que Microsoft Excel utilise lors de la création de nouveaux graphiques.

SetElement - Définit les éléments dans un graphique de graphique. En lecture/écriture MsoChartElementType.

SetProperty -

SetSourceData - Définit la plage de données sources du graphique.

Unprotect - Cette méthode supprime la protection d'une feuille ou d'un classeur. Elle est sans effet si la feuille ou le classeur n'est pas protégé.

Propriétés

AutoScaling La valeur true si Microsoft Excel met à l'échelle un graphique en 3D de sorte qu'il soit plus proche en taille du graphique 2D équivalent. La propriété RightAngleAxes doit avoir la valeur True. Boolean (en lecture/écriture).

BackWall Renvoie un objet Walls qui permet à l'utilisateur de mettre en forme individuellement le mur arrière d'un graphique en 3D. En lecture seule.

BarShape Cette propriété renvoie ou définit la forme utilisée avec la barre 3D ou le graphique en histogrammes. En lecture/écriture XlBarShape.

CategoryLabelLevel Renvoie une constante XlCategoryLabelLevel qui fait référence au niveau d'origine des étiquettes de catégorie. Type de données Integer en lecture-écriture.

ChartArea Renvoie un objet ChartArea qui représente la zone de graphique complète pour le graphique. En lecture seule.

ChartColor Cette propriété renvoie ou définit un entier qui représente le jeu de couleurs du graphique. Lecture-écriture.

ChartStyle Cette propriété renvoie ou définit le style de graphique du graphique. Variant en lecture/écriture.

ChartTitle Renvoie un objet ChartTitle qui représente le titre du graphique spécifié. En lecture seule.

ChartType Renvoie ou définit le type de graphique. Énumération XlChartType en lecture-écriture.

CodeName Cette propriété renvoie le nom de code de l’objet. Type de données String en lecture seule.

DataTable Renvoie un objet DataTable qui représente la table de données du graphique. En lecture seule.

DepthPercent Cette propriété renvoie ou définit la profondeur d'un graphique en 3D sous la forme d'un pourcentage de la largeur du graphique (entre 20 et 2000 pour cent). Type de données Long en lecture-écriture.

DisplayBlanksAs Cette propriété renvoie ou définit le mode d'affichage que les cellules vides sont tracées dans un graphique. Peut être une des constantes XlDisplayBlanksAs. Long (en lecture/écriture).

DisplayValueNotAvailableAsBlank

Elevation Cette propriété renvoie ou définit l'altitude de l'affichage de graphique en 3D, en degrés. Type de données Long en lecture-écriture.

Floor Renvoie un objet Floor qui représente le plancher du graphique en 3D. En lecture seule.

GapDepth Cette propriété renvoie ou définit la distance entre les séries de données d’un graphique en 3D sous la forme d’un pourcentage de la largeur de marque. La valeur de cette propriété doit être comprise entre 0 et 500. Long (en lecture/écriture).

HasAxis Cette propriété renvoie ou définit quels sont les axes existants du graphique. Variant en lecture/écriture.

HasDataTable Cette propriété a la valeur True si le graphique possède une table de données. Boolean (en lecture/écriture).

HasLegend Cette propriété a la valeur True si le graphique possède une légende. Boolean (en lecture/écriture).

HasTitle Cette propriété a la valeur True si l'axe ou le graphique possède un titre visible. Boolean (en lecture/écriture).

HeightPercent Cette propriété renvoie ou définit la hauteur d'un graphique en 3D sous la forme d'un pourcentage de la largeur du graphique (entre 5 et 500 pour cent). Long (en lecture/écriture).

Hyperlinks Renvoie une collection Hyperlinks qui représente les liens hypertexte du graphique.

Index Cette propriété renvoie une valeur de type Long qui représente le numéro d'index de l'objet au sein de la collection d'objets similaires.

Legend Renvoie un objet Legend qui représente la légende du graphique. En lecture seule.

MailEnvelope Représente un en-tête de message électronique pour un document.

Name Cette propriété renvoie ou définit une valeur de type String qui représente le nom de l'objet.

Next Renvoie un objet Worksheet qui représente la feuille suivante.

PageSetup Renvoie un objet PageSetup qui contient tous les paramètres de mise en page de l'objet spécifié. En lecture seule.

Perspective Cette propriété renvoie ou définit une valeur de type long qui représente la perspective de l'affichage de graphique 3D.

PivotLayout Renvoie un objet PivotLayout qui représente le positionnement des champs dans un rapport de tableau croisé dynamique et l'emplacement des axes dans un rapport de graphique croisé dynamique. En lecture seule.

PlotArea Renvoie un objet PlotArea qui représente la zone de traçage d'un graphique. En lecture seule.

PlotBy Renvoie ou spécifie la façon dont les colonnes ou les lignes sont utilisées comme séries de données sur le graphique. Il peut s'agir de l'une des constantes XlRowCol suivantes: xlColumns ou xlRows. Long (en lecture/écriture).

PlotVisibleOnly True si seules les cellules visibles sont tracées. False si les cellules visibles et masquées sont tracées. Boolean (en lecture/écriture).

Previous Renvoie un objet Worksheet qui représente la feuille précédente.

PrintedCommentPages Renvoie le nombre de pages de commentaires à imprimer pour le graphique actuel. En lecture seule.

ProtectContents Cette propriété renvoie la valeur True si le contenu de la feuille est protégé. Pour un graphique, cela protège le graphique entier. Pour activer la protection du contenu, utilisez la méthode Protect avec l'argument content défini sur true. Boolean (en lecture seule).

ProtectData Cette propriété a la valeur True si les formules des séries ne peuvent pas être modifiées par l'utilisateur. Boolean (en lecture/écriture).

ProtectDrawingObjects Cette propriété renvoie la valeur True si les formes sont protégées. Pour activer la protection des formes, utilisez la méthode Protect avec l'argument DrawingObjects défini sur true. Boolean (en lecture seule).

ProtectFormatting Cette propriété a la valeur True si la mise en forme du graphique ne peut pas être modifiée par l'utilisateur. Boolean (en lecture/écriture).

ProtectionMode Cette propriété renvoie la valeur True si la protection Interface utilisateur seulement est activée. Pour activer la protection de l’interface utilisateur, utilisez la méthode Protect avec l’argument InterfaceUtilisateurUniquement défini sur true. Boolean (en lecture seule).

ProtectSelection Cette propriété a la valeur True si les éléments d'un graphique ne peuvent pas être sélectionnés. Boolean (en lecture/écriture).

RightAngleAxes Cette propriété a la valeur True si les axes du graphique se coupent à angle droit, quelle que soit la rotation ou l’élévation du graphique. S’applique uniquement aux graphiques en courbes, en histogrammes et en barres. Boolean (en lecture/écriture).

Rotation Cette propriété renvoie ou définit la rotation de l'affichage graphique 3D (la rotation de la zone de traçage autour de l'axe z, en degrés). La valeur de cette propriété doit être comprise entre 0 et 360, à l'exception des graphiques à barres 3D, où la valeur doit être comprise entre 0 et 44. La valeur par défaut est 20. S'applique uniquement aux graphiques 3D. Variant en lecture/écriture.

SeriesNameLevel Renvoie une constante XlSeriesNameLevel qui fait référence au niveau d'origine des noms de série. Type de données Integer en lecture-écriture.

Shapes Renvoie une collection Shapes qui représente toutes les formes de la feuille de graphique. En lecture seule.

ShowAllFieldButtons Renvoie ou définit si tous les boutons de champ d'un graphique croisé dynamique doivent être affichés. En lecture-écriture.

ShowAxisFieldButtons Renvoie ou définit si tous les boutons de champ d'axe d'un graphique croisé dynamique doivent être affichés. En lecture-écriture.

ShowDataLabelsOverMaximum Cette propriété renvoie ou définit s'il faut afficher les étiquettes de données lorsque la valeur est supérieure à la valeur maximale de l'axe des ordonnées. Boolean (en lecture/écriture).

ShowExpandCollapseEntireFieldButtons Vrai pour afficher les boutons Développer le champ entier et Réduire le champ entier dans le graphique croisé dynamique spécifié. Boolean (en lecture/écriture).

ShowLegendFieldButtons Renvoie ou définit si tous les boutons de champ de légende d’un graphique croisé dynamique doivent être affichés. Lecture-écriture.

ShowReportFilterFieldButtons Renvoie ou définit si tous les boutons de champ de filtre de rapport d'un graphique croisé dynamique doivent être affichés. En lecture-écriture.

ShowValueFieldButtons Renvoie ou définit si tous les boutons de champ de valeur d'un graphique croisé dynamique doivent être affichés. En lecture-écriture.

SideWall Renvoie un objet Walls qui permet à l'utilisateur de mettre en forme individuellement le mur latéral d'un graphique en 3D. En lecture seule.

Tab Renvoie un objet Tab pour un graphique.

Visible Cette propriété renvoie ou définit une valeur XlSheetVisibility qui détermine si l'objet est visible.

Walls Renvoie un objet Walls qui représente les murs du graphique en 3D. En lecture seule.

Axes - Collection de tous les objets Axis du graphique spécifié.

ChartArea - Cet objet représente la zone de graphique d'un graphique (chart).

ChartGroups - Cet objet représente une ou plusieurs séries tracées dans un graphique avec le même format.

ChartObjects - Collection de tous les objets ChartObject de la feuille de graphique, de la feuille de dialogue ou de la feuille de calcul spécifiée.

ChartTitle - Cet objet représente le titre du graphique.

DataTable - Cet objet représente un tableau de données graphiques.

Floor - Représente le plancher d'un graphique 3D.

FullSeriesCollection - Représente l'ensemble complet des objets Series d'un graphique.

Hyperlinks - Représente la collection de liens hypertexte d'une plage ou d'une feuille de calcul.

Legend - Représente la légende d’un graphique.

OLEObjects - Collection de tous les objets OLEObject de la feuille de calcul spécifiée.

PageSetup - Cet objet représente une description de mise en page.

PivotLayout - Cet objet représente la disposition des champs dans un rapport de graphique croisé dynamique.

PlotArea - Cet objet représente la zone de traçage d'un graphique.

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

Shapes - Collection de tous les objets Shape de la feuille spécifiée.

Tab - Représente l'onglet d'un graphique ou d'une feuille de calcul.

Walls - Représente les murs d'un graphique en 3D.

Worksheet - Représente une feuille de calcul.