Classe DataLabel (Excel VBA)

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

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 = ActiveCell.Width(1).DataLabel

Les procédures suivantes peuvent être utilisés pour définir des variables de la classe DataLabel : DataLabels.Item, Point.DataLabel, 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 ActiveCell.Width.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

Formula with its procedures Formula, FormulaLocal, FormulaR1C1 et FormulaR1C1Local
Number with its procedures NumberFormatLinked, NumberFormatLocal, DataLabels.NumberFormatLinked et DataLabels.NumberFormatLocal
Sort/Order with its procedures ReadingOrder et DataLabels.ReadingOrder
Display/Show with its procedures ShowBubbleSize, ShowCategoryName, ShowLegendKey, ShowPercentage, ShowRange, ShowSeriesName, DataLabels.ShowBubbleSize, DataLabels.ShowCategoryName, DataLabels.ShowLegendKey, DataLabels.ShowPercentage, DataLabels.ShowRange et DataLabels.ShowSeriesName

Méthodes

Les méthodes principales de la classe DataLabel sont

Delete - Cette méthode supprime l'objet.

ActiveCell.Width(1).DataLabel.Delete

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

ActiveCell.Width(1).DataLabel.Select

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

ActiveChart.FullSeriesCollection(1).DataLabels.Delete

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

ActiveChart.FullSeriesCollection(1).DataLabels.Select

Autre Méthodes

SetProperty -

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

DataLabels.Propagate - Vous permet de prendre le contenu et la mise en forme d'une seule étiquette de données et de l'appliquer à toutes les autres étiquettes de données de la série.

DataLabels.SetProperty -

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. Boolean (en lecture/écriture).

ActiveCell.Width(1).DataLabel.AutoText = True

Caption Cette propriété renvoie ou définit une valeur de type String qui représente le texte de l'étiquette des données.

ActiveCell.Width(1).DataLabel.Caption =

Characters Renvoie un objet Characters qui représente une plage de caractères dans le texte de l'objet. Vous pouvez utiliser l’objet Characters pour mettre en forme les caractères d’une chaîne de texte.

Dim chrsCharacters As Characters
Set chrsCharacters = ActiveCell.Width(1).DataLabel.Characters

Format Renvoie l'objet ChartFormat . En lecture seule.

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveCell.Width(1).DataLabel.Format

Height Renvoie la hauteur de l'objet en points. Lecture-écriture.

ActiveCell.Width(1).DataLabel.Height =

HorizontalAlignment Cette propriété renvoie ou définit une valeur de type Variant qui représente l’alignement horizontal de l’objet spécifié.

ActiveCell.Width(1).DataLabel.HorizontalAlignment = xlHAlignCenter

Left Cette propriété renvoie ou définit une valeur de type double qui représente la distance en pointsentre le bord gauche de l'objet et le bord gauche de colonne a (dans une feuille de calcul) ou le bord gauche de la zone de graphique (dans un graphique).

ActiveCell.Width(1).DataLabel.Left =

Name Renvoie une valeur de type String qui représente le nom de l'objet.

Dim strName As String
strName = ActiveCell.Width(1).DataLabel.Name

NumberFormat Cette propriété renvoie ou définit une valeur de type String qui représente le code du format de l'objet.

ActiveCell.Width(1).DataLabel.NumberFormat =

Orientation Cette propriété renvoie ou définit une valeur de type Variant qui représente l'orientation de texte.

ActiveCell.Width(1).DataLabel.Orientation = xlDownward

Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveCell.Width(1).DataLabel.Parent

Position Cette propriété renvoie ou définit une valeur XlDataLabelPosition qui représente la position de l'étiquette de données.

ActiveCell.Width(1).DataLabel.Position = xlLabelPositionAbove

Separator Renvoie ou définit une valeur de type Variant qui représente le séparateur utilisé pour les étiquettes de données dans un graphique. Lecture-écriture.

ActiveCell.Width(1).DataLabel.Separator = ";"

Shadow Cette propriété renvoie ou définit une valeur de type Boolean qui détermine si l'objet est ombré.

ActiveCell.Width(1).DataLabel.Shadow = True

ShowValue Cette propriété renvoie ou définit un objet de type Boolean correspondant à un comportement d'affichage des valeurs d'étiquettes de données d'un graphique spécifié. La valeur True affiche les valeurs. La valeur False les masque. Lecture-écriture.

ActiveCell.Width(1).DataLabel.ShowValue = True

Text Cette propriété renvoie ou définit le texte de l'objet spécifié. String en lecture/écriture.

ActiveCell.Width(1).DataLabel.Text =

Top Cette propriété renvoie ou définit une valeur de type double qui représente la distance en pointsentre le bord supérieur de l'objet et le haut de ligne 1 (dans une feuille de calcul) ou le haut de la zone de graphique (dans un graphique).

ActiveCell.Width(1).DataLabel.Top =

VerticalAlignment Cette propriété renvoie ou définit une valeur de type Variant qui représente l’alignement vertical de l’objet spécifié.

ActiveCell.Width(1).DataLabel.VerticalAlignment = xlVAlignBottom

Width Renvoie la largeur de l'objet en points. En lecture seule.

ActiveCell.Width(1).DataLabel.Width =

DataLabels.AutoText Cette propriété a la valeur True si l'objet génère automatiquement le texte approprié en fonction du contexte. Boolean (en lecture/écriture).

ActiveChart.FullSeriesCollection(1).DataLabels.AutoText = True

DataLabels.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.FullSeriesCollection(1).DataLabels.Count

DataLabels.Format Renvoie l'objet ChartFormat . En lecture seule.

Dim cftFormatted As ChartFormat
Set cftFormatted = ActiveChart.FullSeriesCollection(1).DataLabels.Format

DataLabels.HorizontalAlignment Cette propriété renvoie ou définit une valeur de type Variant qui représente l’alignement horizontal de l’objet spécifié.

ActiveChart.FullSeriesCollection(1).DataLabels.HorizontalAlignment = xlHAlignCenter

DataLabels.Name Renvoie une valeur de type String qui représente le nom de l'objet.

Dim strName As String
strName = ActiveChart.FullSeriesCollection(1).DataLabels.Name

DataLabels.NumberFormat Cette propriété renvoie ou définit une valeur de type String qui représente le code du format de l'objet.

ActiveChart.FullSeriesCollection(1).DataLabels.NumberFormat =

DataLabels.Orientation Cette propriété renvoie ou définit une valeur de type Variant qui représente l'orientation de texte.

ActiveChart.FullSeriesCollection(1).DataLabels.Orientation = xlDownward

DataLabels.Parent Renvoie l’objet parent pour l’objet spécifié. En lecture seule.

Dim objParent As Object
Set objParent = ActiveChart.FullSeriesCollection(1).DataLabels.Parent

DataLabels.Position Cette propriété renvoie ou définit une valeur XlDataLabelPosition qui représente la position de l'étiquette de données.

ActiveChart.FullSeriesCollection(1).DataLabels.Position = xlLabelPositionAbove

DataLabels.Separator Renvoie ou définit une valeur de type Variant qui représente le séparateur utilisé pour les étiquettes de données dans un graphique. Lecture-écriture.

ActiveChart.FullSeriesCollection(1).DataLabels.Separator = ";"

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

ActiveChart.FullSeriesCollection(1).DataLabels.Shadow = True

DataLabels.ShowValue Cette propriété renvoie ou définit un objet de type Boolean correspondant à un comportement d'affichage des valeurs d'étiquettes de données d'un graphique spécifié. La valeur True affiche les valeurs. La valeur False les masque. Lecture-écriture.

ActiveChart.FullSeriesCollection(1).DataLabels.ShowValue = True

DataLabels.VerticalAlignment Cette propriété renvoie ou définit une valeur de type Variant qui représente l’alignement vertical de l’objet spécifié.

ActiveChart.FullSeriesCollection(1).DataLabels.VerticalAlignment = xlVAlignBottom