Classe DataLabel (Word VBA)

Cet objet représente l'étiquette de données sur une courbe de tendance ou un point d'un graphique.

Les procédures principales de la classe DataLabel sont Delete, Select, DataLabels.Delete et DataLabels.Select

Set

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

Dim dtl as DataLabel
Set dtl = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels()

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe DataLabel : DataLabels.Item, Point.DataLabel, Series.DataLabels, Trendline.DataLabel et Series.DataLabels

For Each

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

Dim dtl As DataLabel
For Each dtl In ActiveDocument.Background.Chart.FullSeriesCollection.DataLabels()
	
Next dtl

Thèmes

Certaines procédures de cette classe ont été regroupées en thèmes et sont décrites sur des pages thématiques séparées

Format with its procedures Format, NumberFormat, DataLabels.Format et DataLabels.NumberFormat
Formula with its procedures Formula, FormulaLocal, FormulaR1C1 et FormulaR1C1Local
Number with its procedures NumberFormatLinked, NumberFormatLocal, DataLabels.NumberFormatLinked et DataLabels.NumberFormatLocal
Display/Show with its procedures ShowBubbleSize, ShowLegendKey, ShowPercentage, ShowRange, DataLabels.ShowBubbleSize, DataLabels.ShowLegendKey, DataLabels.ShowPercentage et DataLabels.ShowRange

Méthodes

Les méthodes principales de la classe DataLabel sont

Delete - Cette méthode supprime l'objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Delete

Select - Cette méthode sélectionne l'objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Select

DataLabels.Delete - Cette méthode supprime l'objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Delete

DataLabels.Select - Cette méthode sélectionne l'objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Select

Propriétés

AutoText Cette propriété a la valeur True si l'objet génère automatiquement le texte approprié en fonction du contexte.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.AutoText = True

Caption Renvoie ou définit le texte de l’étiquette de données.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Caption =

Characters Renvoie un objet ChartCharacters qui représente une plage de caractères dans le texte de l’objet.

Dim ccsCharacters As ChartCharacters
Set ccsCharacters = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Characters

Height Obtient ou définit la hauteur, exprimée en points, de l’objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Height =

HorizontalAlignment Cette propriété renvoie ou définit l'alignement horizontal de l'objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.HorizontalAlignment = xl3DBar

Left Cette propriété renvoie ou définit la distance, en points, entre le bord gauche de l’objet et le bord gauche de la zone de graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Left =

Name Renvoie le nom de l'objet.

Dim strName As String
strName = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Name

Orientation Cette propriété renvoie ou définit l'orientation du texte.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Orientation =

Parent Renvoie le parent de l'objet spécifié.

Dim objParent As Object
Set objParent = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Parent

Position Renvoie ou définit la position de l'étiquette de données.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Position = xlLabelPositionAbove

ReadingOrder Cette propriété renvoie ou définit une constante XlReadingOrder qui représente le sens de lecture de l’objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ReadingOrder =

Separator Cette propriété renvoie ou définit le séparateur utilisé pour les étiquettes de données dans un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Separator =

Shadow Cette propriété renvoie ou définit une valeur qui indique si l'objet est ombré.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Shadow = True

ShowCategoryName True pour afficher le nom de catégorie pour les étiquettes de données dans un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowCategoryName = True

ShowSeriesName True pour afficher le nom de la série des étiquettes de données sur un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowSeriesName = True

ShowValue True pour afficher les valeurs d'étiquette de données du graphique spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowValue = True

Text Cette propriété renvoie ou définit le texte de l'objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Text =

Top Cette propriété renvoie ou définit la distance, en points, entre le bord supérieur de l’objet et le haut de la première ligne (dans une feuille de calcul) ou le haut de la zone de graphique (dans un graphique).

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Top =

VerticalAlignment Cette propriété renvoie ou définit l'alignement vertical de l'objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.VerticalAlignment = xl3DBar

Width Obtient ou définit la largeur, exprimée en points, de l’objet.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Width =

DataLabels.AutoText True si tous les objets de la collection génèrent automatiquement le texte approprié en fonction du contexte.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.AutoText = True

DataLabels.Count Renvoie le nombre d'objets dans la collection.

Dim lngCount As Long
lngCount = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Count

DataLabels.HorizontalAlignment Cette propriété renvoie ou définit l'alignement horizontal de l'objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.HorizontalAlignment = xl3DBar

DataLabels.Name Renvoie le nom de l'objet.

Dim strName As String
strName = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Name

DataLabels.Orientation Cette propriété renvoie ou définit l'orientation du texte.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Orientation =

DataLabels.Parent Renvoie le parent de l'objet spécifié.

Dim objParent As Object
Set objParent = ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Parent

DataLabels.Position Renvoie ou définit la position des étiquettes de données.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Position = xlLabelPositionAbove

DataLabels.ReadingOrder Cette propriété renvoie ou définit une constante XlReadingOrder qui représente le sens de lecture de l’objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ReadingOrder =

DataLabels.Separator Cette propriété renvoie ou définit le séparateur des étiquettes de données d’un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Separator =

DataLabels.Shadow Cette propriété renvoie ou définit une valeur qui indique si l'objet est ombré.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.Shadow = True

DataLabels.ShowCategoryName True pour afficher le nom de catégorie pour les étiquettes de données dans un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowCategoryName = True

DataLabels.ShowSeriesName True pour afficher le nom de la série des étiquettes de données sur un graphique.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowSeriesName = True

DataLabels.ShowValue True pour afficher les données étiquettent les valeurs d'un graphique spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.ShowValue = True

DataLabels.VerticalAlignment Cette propriété renvoie ou définit l'alignement vertical de l'objet spécifié.

ActiveDocument.Background.Chart.FullSeriesCollection(1).DataLabels.VerticalAlignment = xl3DBar