ExcelScript.ChartDataLabel interface

Paquet:

ExcelScript

Représente l’étiquette de données d’un point de graphique.

Remarques

Utilisateur

• ExcelScript.ChartPoint : getDataLabel

Méthodes

getAutoText()	Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte.
getFormat()	Représente le format d’étiquette de données graphique.
getFormula()	Valeur de chaîne qui représente la formule de l’étiquette de données du graphique à l’aide de la notation de style A1.
getGeometricShapeType()	Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article ExcelScript.GeometricShapeType. La valeur est null si l’étiquette de données n’est pas une forme géométrique.
getHeight()	Représente la hauteur, exprimée en points, de l’étiquette de données du graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
getHorizontalAlignment()	Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextHorizontalAlignment . Cette propriété est valide uniquement lorsque TextOrientation l’étiquette de données est -90, 90 ou 180.
getLeft()	Représente la distance en points, du bord gauche de l’étiquette de données graphique au bord gauche de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
getLinkNumberFormat()	Spécifie si le format de nombre est lié aux cellules (de sorte que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).
getNumberFormat()	Spécifie le code de format pour l’étiquette de données.
getPosition()	Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez ExcelScript.ChartDataLabelPosition .
getSeparator()	Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique.
getShowAsStickyCallout()	Spécifie si l’étiquette de données est affichée sous forme de légende avec l’ancre de fin attachée au point de données. Si truela valeur est , la légende est l’une des valeurs suivantes : « AccentCallout1 », « AccentCallout2 », « BorderCallout1 », « BorderCallout2 », « WedgeRectCallout », « WedgeRRectCallout » ou « WedgeEllipseCallout ».
getShowBubbleSize()	Spécifie si la taille de la bulle d’étiquette de données est visible.
getShowCategoryName()	Spécifie si le nom de la catégorie d’étiquette de données est visible.
getShowLegendKey()	Spécifie si la clé de légende d’étiquette de données est visible.
getShowPercentage()	Spécifie si le pourcentage d’étiquette de données est visible.
getShowSeriesName()	Spécifie si le nom de la série d’étiquettes de données est visible.
getShowValue()	Spécifie si la valeur de l’étiquette de données est visible.
getSubstring(start, length)	Retourne une sous-chaîne de l’étiquette de données. Le caractère de saut de ligne '\n' compte comme un caractère.
getTailAnchor()	Retourne l’ancre de fin de l’étiquette de données qui est affichée sous la forme d’une légende collante.
getText()	Chaîne représentant le texte d’étiquette de données dans un graphique.
getTextOrientation()	Représente l’angle vers lequel le texte est orienté pour l’étiquette de données du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.
getTop()	Représente la distance en points, du bord supérieur de l’étiquette de données graphique au bord supérieur de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
getVerticalAlignment()	Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextVerticalAlignment . Cette propriété n’est valide que lorsque TextOrientation l’étiquette de données est 0.
getWidth()	Représente la largeur, exprimée en points, de l’étiquette de données du graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
setAutoText(autoText)	Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte.
setFormula(formula)	Valeur de chaîne qui représente la formule de l’étiquette de données du graphique à l’aide de la notation de style A1.
setGeometricShapeType(geometricShapeType)	Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article ExcelScript.GeometricShapeType. La valeur est null si l’étiquette de données n’est pas une forme géométrique.
setHeight(height)	Définit la hauteur de l’étiquette de données en points.
setHorizontalAlignment(horizontalAlignment)	Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextHorizontalAlignment . Cette propriété est valide uniquement lorsque TextOrientation l’étiquette de données est -90, 90 ou 180.
setLeft(left)	Représente la distance en points, du bord gauche de l’étiquette de données graphique au bord gauche de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
setLinkNumberFormat(linkNumberFormat)	Spécifie si le format de nombre est lié aux cellules (de sorte que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).
setNumberFormat(numberFormat)	Spécifie le code de format pour l’étiquette de données.
setPosition(position)	Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez ExcelScript.ChartDataLabelPosition .
setSeparator(separator)	Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique.
setShowBubbleSize(showBubbleSize)	Spécifie si la taille de la bulle d’étiquette de données est visible.
setShowCategoryName(showCategoryName)	Spécifie si le nom de la catégorie d’étiquette de données est visible.
setShowLegendKey(showLegendKey)	Spécifie si la clé de légende d’étiquette de données est visible.
setShowPercentage(showPercentage)	Spécifie si le pourcentage d’étiquette de données est visible.
setShowSeriesName(showSeriesName)	Spécifie si le nom de la série d’étiquettes de données est visible.
setShowValue(showValue)	Spécifie si la valeur de l’étiquette de données est visible.
setText(text)	Chaîne représentant le texte d’étiquette de données dans un graphique.
setTextOrientation(textOrientation)	Représente l’angle vers lequel le texte est orienté pour l’étiquette de données du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.
setTop(top)	Représente la distance en points, du bord supérieur de l’étiquette de données graphique au bord supérieur de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.
setVerticalAlignment(verticalAlignment)	Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextVerticalAlignment . Cette propriété n’est valide que lorsque TextOrientation l’étiquette de données est 0.
setWidth(width)	Définit la largeur de l’étiquette de données en points.

Détails de la méthode

getAutoText()

Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte.

getAutoText(): boolean;

Retours

boolean

getFormat()

Représente le format d’étiquette de données graphique.

getFormat(): ChartDataLabelFormat;

Retours

ExcelScript.ChartDataLabelFormat

getFormula()

Valeur de chaîne qui représente la formule de l’étiquette de données du graphique à l’aide de la notation de style A1.

getFormula(): string;

Retours

string

getGeometricShapeType()

Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article ExcelScript.GeometricShapeType. La valeur est null si l’étiquette de données n’est pas une forme géométrique.

getGeometricShapeType(): GeometricShapeType;

Retours

ExcelScript.GeometricShapeType

getHeight()

Représente la hauteur, exprimée en points, de l’étiquette de données du graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

getHeight(): number;

Retours

number

getHorizontalAlignment()

Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextHorizontalAlignment . Cette propriété est valide uniquement lorsque TextOrientation l’étiquette de données est -90, 90 ou 180.

getHorizontalAlignment(): ChartTextHorizontalAlignment;

Retours

ExcelScript.ChartTextHorizontalAlignment

getLeft()

Représente la distance en points, du bord gauche de l’étiquette de données graphique au bord gauche de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

getLeft(): number;

Retours

number

getLinkNumberFormat()

Spécifie si le format de nombre est lié aux cellules (de sorte que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).

getLinkNumberFormat(): boolean;

Retours

boolean

getNumberFormat()

Spécifie le code de format pour l’étiquette de données.

getNumberFormat(): string;

Retours

string

getPosition()

Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez ExcelScript.ChartDataLabelPosition .

getPosition(): ChartDataLabelPosition;

Retours

ExcelScript.ChartDataLabelPosition

getSeparator()

Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique.

getSeparator(): string;

Retours

string

getShowAsStickyCallout()

Spécifie si l’étiquette de données est affichée sous forme de légende avec l’ancre de fin attachée au point de données. Si truela valeur est , la légende est l’une des valeurs suivantes : « AccentCallout1 », « AccentCallout2 », « BorderCallout1 », « BorderCallout2 », « WedgeRectCallout », « WedgeRRectCallout » ou « WedgeEllipseCallout ».

getShowAsStickyCallout(): boolean;

Retours

boolean

getShowBubbleSize()

Spécifie si la taille de la bulle d’étiquette de données est visible.

getShowBubbleSize(): boolean;

Retours

boolean

getShowCategoryName()

Spécifie si le nom de la catégorie d’étiquette de données est visible.

getShowCategoryName(): boolean;

Retours

boolean

getShowLegendKey()

Spécifie si la clé de légende d’étiquette de données est visible.

getShowLegendKey(): boolean;

Retours

boolean

getShowPercentage()

Spécifie si le pourcentage d’étiquette de données est visible.

getShowPercentage(): boolean;

Retours

boolean

getShowSeriesName()

Spécifie si le nom de la série d’étiquettes de données est visible.

getShowSeriesName(): boolean;

Retours

boolean

getShowValue()

Spécifie si la valeur de l’étiquette de données est visible.

getShowValue(): boolean;

Retours

boolean

getSubstring(start, length)

Retourne une sous-chaîne de l’étiquette de données. Le caractère de saut de ligne '\n' compte comme un caractère.

getSubstring(start: number, length?: number): ChartFormatString;

Paramètres

start

number

Position du caractère de départ de base zéro d’une sous-chaîne dans l’étiquette de données.

length

number

Facultatif. Nombre de caractères dans la sous-chaîne. Si length est omis, tous les caractères du début à la fin de l’étiquette de données sont récupérés.

Retours

ExcelScript.ChartFormatString

getTailAnchor()

Retourne l’ancre de fin de l’étiquette de données qui est affichée sous la forme d’une légende collante.

getTailAnchor(): ChartDataLabelAnchor;

Retours

ExcelScript.ChartDataLabelAnchor

getText()

Chaîne représentant le texte d’étiquette de données dans un graphique.

getText(): string;

Retours

string

getTextOrientation()

Représente l’angle vers lequel le texte est orienté pour l’étiquette de données du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.

getTextOrientation(): number;

Retours

number

getTop()

Représente la distance en points, du bord supérieur de l’étiquette de données graphique au bord supérieur de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

getTop(): number;

Retours

number

getVerticalAlignment()

Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextVerticalAlignment . Cette propriété n’est valide que lorsque TextOrientation l’étiquette de données est 0.

getVerticalAlignment(): ChartTextVerticalAlignment;

Retours

ExcelScript.ChartTextVerticalAlignment

getWidth()

Représente la largeur, exprimée en points, de l’étiquette de données du graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

getWidth(): number;

Retours

number

setAutoText(autoText)

Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte.

setAutoText(autoText: boolean): void;

Paramètres

autoText

boolean

Retours

void

setFormula(formula)

Valeur de chaîne qui représente la formule de l’étiquette de données du graphique à l’aide de la notation de style A1.

setFormula(formula: string): void;

Paramètres

formula

string

Retours

void

setGeometricShapeType(geometricShapeType)

Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article ExcelScript.GeometricShapeType. La valeur est null si l’étiquette de données n’est pas une forme géométrique.

setGeometricShapeType(geometricShapeType: GeometricShapeType): void;

Paramètres

geometricShapeType

ExcelScript.GeometricShapeType

Retours

void

setHeight(height)

Définit la hauteur de l’étiquette de données en points.

setHeight(height: number): void;

Paramètres

height

number

Hauteur de l’étiquette de données en points.

Retours

void

setHorizontalAlignment(horizontalAlignment)

Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextHorizontalAlignment . Cette propriété est valide uniquement lorsque TextOrientation l’étiquette de données est -90, 90 ou 180.

setHorizontalAlignment(
            horizontalAlignment: ChartTextHorizontalAlignment
        ): void;

Paramètres

horizontalAlignment

ExcelScript.ChartTextHorizontalAlignment

Retours

void

setLeft(left)

Représente la distance en points, du bord gauche de l’étiquette de données graphique au bord gauche de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

setLeft(left: number): void;

Paramètres

left

number

Retours

void

setLinkNumberFormat(linkNumberFormat)

Spécifie si le format de nombre est lié aux cellules (de sorte que le format des nombres change dans les étiquettes lorsqu’il change dans les cellules).

setLinkNumberFormat(linkNumberFormat: boolean): void;

Paramètres

linkNumberFormat

boolean

Retours

void

setNumberFormat(numberFormat)

Spécifie le code de format pour l’étiquette de données.

setNumberFormat(numberFormat: string): void;

Paramètres

numberFormat

string

Retours

void

setPosition(position)

Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez ExcelScript.ChartDataLabelPosition .

setPosition(position: ChartDataLabelPosition): void;

Paramètres

position

ExcelScript.ChartDataLabelPosition

Retours

void

setSeparator(separator)

Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique.

setSeparator(separator: string): void;

Paramètres

separator

string

Retours

void

setShowBubbleSize(showBubbleSize)

Spécifie si la taille de la bulle d’étiquette de données est visible.

setShowBubbleSize(showBubbleSize: boolean): void;

Paramètres

showBubbleSize

boolean

Retours

void

setShowCategoryName(showCategoryName)

Spécifie si le nom de la catégorie d’étiquette de données est visible.

setShowCategoryName(showCategoryName: boolean): void;

Paramètres

showCategoryName

boolean

Retours

void

setShowLegendKey(showLegendKey)

Spécifie si la clé de légende d’étiquette de données est visible.

setShowLegendKey(showLegendKey: boolean): void;

Paramètres

showLegendKey

boolean

Retours

void

setShowPercentage(showPercentage)

Spécifie si le pourcentage d’étiquette de données est visible.

setShowPercentage(showPercentage: boolean): void;

Paramètres

showPercentage

boolean

Retours

void

setShowSeriesName(showSeriesName)

Spécifie si le nom de la série d’étiquettes de données est visible.

setShowSeriesName(showSeriesName: boolean): void;

Paramètres

showSeriesName

boolean

Retours

void

setShowValue(showValue)

Spécifie si la valeur de l’étiquette de données est visible.

setShowValue(showValue: boolean): void;

Paramètres

showValue

boolean

Retours

void

setText(text)

Chaîne représentant le texte d’étiquette de données dans un graphique.

setText(text: string): void;

Paramètres

text

string

Retours

void

setTextOrientation(textOrientation)

Représente l’angle vers lequel le texte est orienté pour l’étiquette de données du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.

setTextOrientation(textOrientation: number): void;

Paramètres

textOrientation

number

Retours

void

setTop(top)

Représente la distance en points, du bord supérieur de l’étiquette de données graphique au bord supérieur de la zone de graphique. La valeur est null si l’étiquette de données du graphique n’est pas visible.

setTop(top: number): void;

Paramètres

top

number

Retours

void

setVerticalAlignment(verticalAlignment)

Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez ExcelScript.ChartTextVerticalAlignment . Cette propriété n’est valide que lorsque TextOrientation l’étiquette de données est 0.

setVerticalAlignment(
            verticalAlignment: ChartTextVerticalAlignment
        ): void;

Paramètres

verticalAlignment

ExcelScript.ChartTextVerticalAlignment

Retours

void

setWidth(width)

Définit la largeur de l’étiquette de données en points.

setWidth(width: number): void;

Paramètres

width

number

Largeur de l’étiquette de données en points.

Retours

void