Partager via


ExcelScript.ChartDataLabel interface

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

Méthode

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;

Retourne

boolean

getFormat()

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

getFormat(): ChartDataLabelFormat;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

boolean

getNumberFormat()

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

getNumberFormat(): string;

Retourne

string

getPosition()

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

getPosition(): ChartDataLabelPosition;

Retourne

getSeparator()

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

getSeparator(): string;

Retourne

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;

Retourne

boolean

getShowBubbleSize()

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

getShowBubbleSize(): boolean;

Retourne

boolean

getShowCategoryName()

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

getShowCategoryName(): boolean;

Retourne

boolean

getShowLegendKey()

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

getShowLegendKey(): boolean;

Retourne

boolean

getShowPercentage()

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

getShowPercentage(): boolean;

Retourne

boolean

getShowSeriesName()

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

getShowSeriesName(): boolean;

Retourne

boolean

getShowValue()

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

getShowValue(): boolean;

Retourne

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.

Retourne

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;

Retourne

getText()

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

getText(): string;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

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;

Retourne

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

Retourne

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

Retourne

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

Retourne

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.

Retourne

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

Retourne

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

Retourne

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

Retourne

void

setNumberFormat(numberFormat)

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

setNumberFormat(numberFormat: string): void;

Paramètres

numberFormat

string

Retourne

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

Retourne

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

Retourne

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

Retourne

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

Retourne

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

Retourne

void

setShowPercentage(showPercentage)

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

setShowPercentage(showPercentage: boolean): void;

Paramètres

showPercentage

boolean

Retourne

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

Retourne

void

setShowValue(showValue)

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

setShowValue(showValue: boolean): void;

Paramètres

showValue

boolean

Retourne

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

Retourne

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

Retourne

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

Retourne

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

Retourne

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.

Retourne

void