ExcelScript.ChartDataLabel interface
Représente l’étiquette de données d’un point de graphique.
Méthode
| get |
Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte. |
| get |
Représente le format d’étiquette de données graphique. |
| get |
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. |
| get |
Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article |
| get |
Représente la hauteur, exprimée en points, de l’étiquette de données du graphique. La valeur est |
| get |
Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez |
| get |
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 |
| get |
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). |
| get |
Spécifie le code de format pour l’étiquette de données. |
| get |
Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez |
| get |
Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique. |
| get |
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 |
| get |
Spécifie si la taille de la bulle d’étiquette de données est visible. |
| get |
Spécifie si le nom de la catégorie d’étiquette de données est visible. |
| get |
Spécifie si la clé de légende d’étiquette de données est visible. |
| get |
Spécifie si le pourcentage d’étiquette de données est visible. |
| get |
Spécifie si le nom de la série d’étiquettes de données est visible. |
| get |
Spécifie si la valeur de l’étiquette de données est visible. |
| get |
Retourne une sous-chaîne de l’étiquette de données. Le caractère de saut de ligne '\n' compte comme un caractère. |
| get |
Retourne l’ancre de fin de l’étiquette de données qui est affichée sous la forme d’une légende collante. |
| get |
Chaîne représentant le texte d’étiquette de données dans un graphique. |
| get |
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. |
| get |
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 |
| get |
Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez |
| get |
Représente la largeur, exprimée en points, de l’étiquette de données du graphique. La valeur est |
| set |
Spécifie si l’étiquette de données génère automatiquement le texte approprié en fonction du contexte. |
| set |
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. |
| set |
Spécifie le type de forme géométrique de l’étiquette de données. Pour plus d’informations, consultez l’article |
| set |
Définit la hauteur de l’étiquette de données en points. |
| set |
Représente l’alignement horizontal de l’étiquette de données du graphique. Pour plus d’informations, consultez |
| set |
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 |
| set |
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). |
| set |
Spécifie le code de format pour l’étiquette de données. |
| set |
Valeur qui représente la position de l’étiquette de données. Pour plus d’informations, consultez |
| set |
Chaîne représentant le séparateur utilisé pour les étiquettes de données d’un graphique. |
| set |
Spécifie si la taille de la bulle d’étiquette de données est visible. |
| set |
Spécifie si le nom de la catégorie d’étiquette de données est visible. |
| set |
Spécifie si la clé de légende d’étiquette de données est visible. |
| set |
Spécifie si le pourcentage d’étiquette de données est visible. |
| set |
Spécifie si le nom de la série d’étiquettes de données est visible. |
| set |
Spécifie si la valeur de l’étiquette de données est visible. |
| set |
Chaîne représentant le texte d’étiquette de données dans un graphique. |
| set |
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. |
| set |
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 |
| set |
Représente l’alignement vertical de l’étiquette de données du graphique. Pour plus d’informations, consultez |
| set |
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
- horizontalAlignment
- ExcelScript.ChartTextHorizontalAlignment
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
- position
- ExcelScript.ChartDataLabelPosition
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
- verticalAlignment
- ExcelScript.ChartTextVerticalAlignment
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