ExcelScript.ChartAxis interface

Colis:

ExcelScript

Représente un axe unique dans un graphique.

Remarques

Exemples

/**
 * This sample customizes the value axis of a chart.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Customize the value axis.
  const valueAxis = chart.getAxes().getValueAxis();
  valueAxis.setMinimum(40000);
  valueAxis.setMaximum(60000);
  valueAxis.setDisplayUnit(ExcelScript.ChartAxisDisplayUnit.thousands);
}

Méthode

getAlignment()	Spécifie l’alignement de l’étiquette de graduation d’axe spécifiée. Consultez pour plus ExcelScript.ChartTextHorizontalAlignment d’informations.
getAxisGroup()	Spécifie le groupe pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisGroup .
getBaseTimeUnit()	Spécifie l’unité de base pour l’axe des catégories spécifié.
getCategoryType()	Spécifie le type d’axe des catégories.
getCustomDisplayUnit()	Spécifie la valeur d’unité d’affichage de l’axe personnalisé. Pour définir cette propriété, utilisez la SetCustomDisplayUnit(double) méthode .
getDisplayUnit()	Représente l’unité d’affichage de l’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisDisplayUnit .
getFormat()	Représente la mise en forme d’un objet de graphique, à savoir le format des lignes et de la police.
getHeight()	Spécifie la hauteur, en points, de l’axe du graphique. Retourne null si l’axe n’est pas visible.
getIsBetweenCategories()	Spécifie si l’axe des valeurs traverse l’axe des catégories entre les catégories.
getLeft()	Spécifie la distance, en points, entre le bord gauche de l’axe et la gauche de la zone de graphique. Retourne null si l’axe n’est pas visible.
getLinkNumberFormat()	Spécifie si le format de nombre est lié aux cellules. Si truela valeur est , le format numérique change dans les étiquettes lorsqu’il change dans les cellules.
getLogBase()	Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques.
getMajorGridlines()	Renvoie un objet qui représente le quadrillage principal de l’axe spécifié.
getMajorTickMark()	Spécifie le type de graduation principale pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .
getMajorTimeUnitScale()	Spécifie la valeur d’échelle d’unité principale pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.
getMajorUnit()	Spécifie l’intervalle entre deux graduations principales.
getMaximum()	Spécifie la valeur maximale sur l’axe des valeurs.
getMinimum()	Spécifie la valeur minimale sur l’axe des valeurs.
getMinorGridlines()	Renvoie un objet qui représente le quadrillage secondaire de l’axe spécifié.
getMinorTickMark()	Spécifie le type de graduation mineure pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .
getMinorTimeUnitScale()	Spécifie la valeur d’échelle d’unité mineure pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.
getMinorUnit()	Spécifie l’intervalle entre deux graduations mineures.
getMultiLevel()	Spécifie si un axe est multiniveau.
getNumberFormat()	Spécifie le code de format de l’étiquette de graduation de l’axe.
getOffset()	Spécifie la distance entre les niveaux des étiquettes et la distance entre le premier niveau et la ligne d’axe. La valeur doit être un entier compris entre 0 et 1000.
getPosition()	Spécifie la position d’axe spécifiée où l’autre axe se croise. Pour plus d’informations, consultez ExcelScript.ChartAxisPosition .
getPositionAt()	Spécifie la position de l’axe où l’autre axe se croise. Vous devez utiliser la SetPositionAt(double) méthode pour définir cette propriété.
getReversePlotOrder()	Spécifie si Excel trace les points de données du dernier au premier.
getScaleType()	Spécifie le type d’échelle de l’axe des valeurs. Pour plus d’informations, consultez ExcelScript.ChartAxisScaleType .
getShowDisplayUnitLabel()	Spécifie si l’étiquette d’unité d’affichage de l’axe est visible.
getTextOrientation()	Spécifie l’angle auquel le texte est orienté pour l’étiquette de graduation de l’axe du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.
getTickLabelPosition()	Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickLabelPosition .
getTickLabelSpacing()	Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation. Il peut s’agir d’une valeur comprise entre 1 et 31999.
getTickMarkSpacing()	Spécifie le nombre de catégories ou de séries entre les graduations.
getTitle()	Représente le titre de l’axe.
getTop()	Spécifie la distance, en points, entre le bord supérieur de l’axe et le haut de la zone de graphique. Retourne null si l’axe n’est pas visible.
getType()	Spécifie le type d’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisType .
getVisible()	Spécifie si l’axe est visible.
getWidth()	Spécifie la largeur, en points, de l’axe du graphique. Retourne null si l’axe n’est pas visible.
setAlignment(alignment)	Spécifie l’alignement de l’étiquette de graduation d’axe spécifiée. Consultez pour plus ExcelScript.ChartTextHorizontalAlignment d’informations.
setBaseTimeUnit(baseTimeUnit)	Spécifie l’unité de base pour l’axe des catégories spécifié.
setCategoryNames(sourceData)	Définit tous les noms de catégorie pour l’axe spécifié.
setCategoryType(categoryType)	Spécifie le type d’axe des catégories.
setCustomDisplayUnit(value)	Définit l’unité d’affichage axe sur une valeur personnalisée.
setDisplayUnit(displayUnit)	Représente l’unité d’affichage de l’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisDisplayUnit .
setIsBetweenCategories(isBetweenCategories)	Spécifie si l’axe des valeurs traverse l’axe des catégories entre les catégories.
setLinkNumberFormat(linkNumberFormat)	Spécifie si le format de nombre est lié aux cellules. Si truela valeur est , le format numérique change dans les étiquettes lorsqu’il change dans les cellules.
setLogBase(logBase)	Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques.
setMajorTickMark(majorTickMark)	Spécifie le type de graduation principale pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .
setMajorTimeUnitScale(majorTimeUnitScale)	Spécifie la valeur d’échelle d’unité principale pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.
setMajorUnit(majorUnit)	Spécifie l’intervalle entre deux graduations principales.
setMaximum(maximum)	Spécifie la valeur maximale sur l’axe des valeurs.
setMinimum(minimum)	Spécifie la valeur minimale sur l’axe des valeurs.
setMinorTickMark(minorTickMark)	Spécifie le type de graduation mineure pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .
setMinorTimeUnitScale(minorTimeUnitScale)	Spécifie la valeur d’échelle d’unité mineure pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.
setMinorUnit(minorUnit)	Spécifie l’intervalle entre deux graduations mineures.
setMultiLevel(multiLevel)	Spécifie si un axe est multiniveau.
setNumberFormat(numberFormat)	Spécifie le code de format de l’étiquette de graduation de l’axe.
setOffset(offset)	Spécifie la distance entre les niveaux des étiquettes et la distance entre le premier niveau et la ligne d’axe. La valeur doit être un entier compris entre 0 et 1000.
setPosition(position)	Spécifie la position d’axe spécifiée où l’autre axe se croise. Pour plus d’informations, consultez ExcelScript.ChartAxisPosition .
setPositionAt(value)	Définit la position d’axe spécifiée où l’autre axe se croise.
setReversePlotOrder(reversePlotOrder)	Spécifie si Excel trace les points de données du dernier au premier.
setScaleType(scaleType)	Spécifie le type d’échelle de l’axe des valeurs. Pour plus d’informations, consultez ExcelScript.ChartAxisScaleType .
setShowDisplayUnitLabel(showDisplayUnitLabel)	Spécifie si l’étiquette d’unité d’affichage de l’axe est visible.
setTextOrientation(textOrientation)	Spécifie l’angle auquel le texte est orienté pour l’étiquette de graduation de l’axe du graphique. La valeur doit être un entier compris entre -90 et 90 ou l’entier 180 pour le texte orienté verticalement.
setTickLabelPosition(tickLabelPosition)	Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickLabelPosition .
setTickLabelSpacing(tickLabelSpacing)	Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation. Il peut s’agir d’une valeur comprise entre 1 et 31999.
setTickMarkSpacing(tickMarkSpacing)	Spécifie le nombre de catégories ou de séries entre les graduations.
setVisible(visible)	Spécifie si l’axe est visible.

Détails de la méthode

getAlignment()

Spécifie l’alignement de l’étiquette de graduation d’axe spécifiée. Consultez pour plus ExcelScript.ChartTextHorizontalAlignment d’informations.

getAlignment(): ChartTickLabelAlignment;

Retourne

ExcelScript.ChartTickLabelAlignment

getAxisGroup()

Spécifie le groupe pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisGroup .

getAxisGroup(): ChartAxisGroup;

Retourne

ExcelScript.ChartAxisGroup

getBaseTimeUnit()

Spécifie l’unité de base pour l’axe des catégories spécifié.

getBaseTimeUnit(): ChartAxisTimeUnit;

Retourne

ExcelScript.ChartAxisTimeUnit

getCategoryType()

Spécifie le type d’axe des catégories.

getCategoryType(): ChartAxisCategoryType;

Retourne

ExcelScript.ChartAxisCategoryType

getCustomDisplayUnit()

Spécifie la valeur d’unité d’affichage de l’axe personnalisé. Pour définir cette propriété, utilisez la SetCustomDisplayUnit(double) méthode .

getCustomDisplayUnit(): number;

Retourne

number

getDisplayUnit()

Représente l’unité d’affichage de l’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisDisplayUnit .

getDisplayUnit(): ChartAxisDisplayUnit;

Retourne

ExcelScript.ChartAxisDisplayUnit

getFormat()

Représente la mise en forme d’un objet de graphique, à savoir le format des lignes et de la police.

getFormat(): ChartAxisFormat;

Retourne

ExcelScript.ChartAxisFormat

getHeight()

Spécifie la hauteur, en points, de l’axe du graphique. Retourne null si l’axe n’est pas visible.

getHeight(): number;

Retourne

number

getIsBetweenCategories()

Spécifie si l’axe des valeurs traverse l’axe des catégories entre les catégories.

getIsBetweenCategories(): boolean;

Retourne

boolean

getLeft()

Spécifie la distance, en points, entre le bord gauche de l’axe et la gauche de la zone de graphique. Retourne null si l’axe n’est pas visible.

getLeft(): number;

Retourne

number

getLinkNumberFormat()

Spécifie si le format de nombre est lié aux cellules. Si truela valeur est , le format numérique change dans les étiquettes lorsqu’il change dans les cellules.

getLinkNumberFormat(): boolean;

Retourne

boolean

getLogBase()

Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques.

getLogBase(): number;

Retourne

number

getMajorGridlines()

Renvoie un objet qui représente le quadrillage principal de l’axe spécifié.

getMajorGridlines(): ChartGridlines;

Retourne

ExcelScript.ChartGridlines

Exemples

/**
 * This sample customizes the gridline color on a chart's value axis.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the gridline color to gray.
  chart.getAxes().getValueAxis().getMajorGridlines().getFormat().getLine().setColor("gray");
}

getMajorTickMark()

Spécifie le type de graduation principale pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .

getMajorTickMark(): ChartAxisTickMark;

Retourne

ExcelScript.ChartAxisTickMark

getMajorTimeUnitScale()

Spécifie la valeur d’échelle d’unité principale pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.

getMajorTimeUnitScale(): ChartAxisTimeUnit;

Retourne

ExcelScript.ChartAxisTimeUnit

getMajorUnit()

Spécifie l’intervalle entre deux graduations principales.

getMajorUnit(): number;

Retourne

number

getMaximum()

Spécifie la valeur maximale sur l’axe des valeurs.

getMaximum(): number;

Retourne

number

getMinimum()

Spécifie la valeur minimale sur l’axe des valeurs.

getMinimum(): number;

Retourne

number

getMinorGridlines()

Renvoie un objet qui représente le quadrillage secondaire de l’axe spécifié.

getMinorGridlines(): ChartGridlines;

Retourne

ExcelScript.ChartGridlines

getMinorTickMark()

Spécifie le type de graduation mineure pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .

getMinorTickMark(): ChartAxisTickMark;

Retourne

ExcelScript.ChartAxisTickMark

getMinorTimeUnitScale()

Spécifie la valeur d’échelle d’unité mineure pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.

getMinorTimeUnitScale(): ChartAxisTimeUnit;

Retourne

ExcelScript.ChartAxisTimeUnit

getMinorUnit()

Spécifie l’intervalle entre deux graduations mineures.

getMinorUnit(): number;

Retourne

number

getMultiLevel()

Spécifie si un axe est multiniveau.

getMultiLevel(): boolean;

Retourne

boolean

getNumberFormat()

Spécifie le code de format de l’étiquette de graduation de l’axe.

getNumberFormat(): string;

Retourne

string

getOffset()

Spécifie la distance entre les niveaux des étiquettes et la distance entre le premier niveau et la ligne d’axe. La valeur doit être un entier compris entre 0 et 1000.

getOffset(): number;

Retourne

number

getPosition()

Spécifie la position d’axe spécifiée où l’autre axe se croise. Pour plus d’informations, consultez ExcelScript.ChartAxisPosition .

getPosition(): ChartAxisPosition;

Retourne

ExcelScript.ChartAxisPosition

getPositionAt()

Spécifie la position de l’axe où l’autre axe se croise. Vous devez utiliser la SetPositionAt(double) méthode pour définir cette propriété.

getPositionAt(): number;

Retourne

number

getReversePlotOrder()

Spécifie si Excel trace les points de données du dernier au premier.

getReversePlotOrder(): boolean;

Retourne

boolean

getScaleType()

Spécifie le type d’échelle de l’axe des valeurs. Pour plus d’informations, consultez ExcelScript.ChartAxisScaleType .

getScaleType(): ChartAxisScaleType;

Retourne

ExcelScript.ChartAxisScaleType

getShowDisplayUnitLabel()

Spécifie si l’étiquette d’unité d’affichage de l’axe est visible.

getShowDisplayUnitLabel(): boolean;

Retourne

boolean

getTextOrientation()

Spécifie l’angle auquel le texte est orienté pour l’étiquette de graduation de l’axe 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

getTickLabelPosition()

Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickLabelPosition .

getTickLabelPosition(): ChartAxisTickLabelPosition;

Retourne

ExcelScript.ChartAxisTickLabelPosition

getTickLabelSpacing()

Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation. Il peut s’agir d’une valeur comprise entre 1 et 31999.

getTickLabelSpacing(): number;

Retourne

number

getTickMarkSpacing()

Spécifie le nombre de catégories ou de séries entre les graduations.

getTickMarkSpacing(): number;

Retourne

number

getTitle()

Représente le titre de l’axe.

getTitle(): ChartAxisTitle;

Retourne

ExcelScript.ChartAxisTitle

getTop()

Spécifie la distance, en points, entre le bord supérieur de l’axe et le haut de la zone de graphique. Retourne null si l’axe n’est pas visible.

getTop(): number;

Retourne

number

getType()

Spécifie le type d’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisType .

getType(): ChartAxisType;

Retourne

ExcelScript.ChartAxisType

getVisible()

Spécifie si l’axe est visible.

getVisible(): boolean;

Retourne

boolean

getWidth()

Spécifie la largeur, en points, de l’axe du graphique. Retourne null si l’axe n’est pas visible.

getWidth(): number;

Retourne

number

setAlignment(alignment)

Spécifie l’alignement de l’étiquette de graduation d’axe spécifiée. Consultez pour plus ExcelScript.ChartTextHorizontalAlignment d’informations.

setAlignment(alignment: ChartTickLabelAlignment): void;

Paramètres

alignment

ExcelScript.ChartTickLabelAlignment

Retourne

void

setBaseTimeUnit(baseTimeUnit)

Spécifie l’unité de base pour l’axe des catégories spécifié.

setBaseTimeUnit(baseTimeUnit: ChartAxisTimeUnit): void;

Paramètres

baseTimeUnit

ExcelScript.ChartAxisTimeUnit

Retourne

void

setCategoryNames(sourceData)

Définit tous les noms de catégorie pour l’axe spécifié.

setCategoryNames(sourceData: Range): void;

Paramètres

sourceData

ExcelScript.Range

Objet Range correspondant aux données sources.

Retourne

void

setCategoryType(categoryType)

Spécifie le type d’axe des catégories.

setCategoryType(categoryType: ChartAxisCategoryType): void;

Paramètres

categoryType

ExcelScript.ChartAxisCategoryType

Retourne

void

setCustomDisplayUnit(value)

Définit l’unité d’affichage axe sur une valeur personnalisée.

setCustomDisplayUnit(value: number): void;

Paramètres

value

number

Valeur personnalisée de l’unité d’affichage.

Retourne

void

setDisplayUnit(displayUnit)

Représente l’unité d’affichage de l’axe. Pour plus d’informations, consultez ExcelScript.ChartAxisDisplayUnit .

setDisplayUnit(displayUnit: ChartAxisDisplayUnit): void;

Paramètres

displayUnit

ExcelScript.ChartAxisDisplayUnit

Retourne

void

Exemples

/**
 * This sample sets the display unit of the value axis to thousands.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the value axis to display in thousands.
  chart.getAxes().getValueAxis().setDisplayUnit(ExcelScript.ChartAxisDisplayUnit.thousands);
}

setIsBetweenCategories(isBetweenCategories)

Spécifie si l’axe des valeurs traverse l’axe des catégories entre les catégories.

setIsBetweenCategories(isBetweenCategories: boolean): void;

Paramètres

isBetweenCategories

boolean

Retourne

void

setLinkNumberFormat(linkNumberFormat)

Spécifie si le format de nombre est lié aux cellules. Si truela valeur est , le format numérique change dans les étiquettes lorsqu’il change dans les cellules.

setLinkNumberFormat(linkNumberFormat: boolean): void;

Paramètres

linkNumberFormat

boolean

Retourne

void

setLogBase(logBase)

Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques.

setLogBase(logBase: number): void;

Paramètres

logBase

number

Retourne

void

setMajorTickMark(majorTickMark)

Spécifie le type de graduation principale pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .

setMajorTickMark(majorTickMark: ChartAxisTickMark): void;

Paramètres

majorTickMark

ExcelScript.ChartAxisTickMark

Retourne

void

setMajorTimeUnitScale(majorTimeUnitScale)

Spécifie la valeur d’échelle d’unité principale pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.

setMajorTimeUnitScale(majorTimeUnitScale: ChartAxisTimeUnit): void;

Paramètres

majorTimeUnitScale

ExcelScript.ChartAxisTimeUnit

Retourne

void

setMajorUnit(majorUnit)

Spécifie l’intervalle entre deux graduations principales.

setMajorUnit(majorUnit: number): void;

Paramètres

majorUnit

number

Retourne

void

setMaximum(maximum)

Spécifie la valeur maximale sur l’axe des valeurs.

setMaximum(maximum: number): void;

Paramètres

maximum

number

Retourne

void

Exemples

/**
 * This sample sets the maximum value on the value axis.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the maximum value to 10.
  chart.getAxes().getValueAxis().setMaximum(10);
}

setMinimum(minimum)

Spécifie la valeur minimale sur l’axe des valeurs.

setMinimum(minimum: number): void;

Paramètres

minimum

number

Retourne

void

Exemples

/**
 * This sample sets the minimum value on the value axis.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the minimum value to 145.
  chart.getAxes().getValueAxis().setMinimum(145);
}

setMinorTickMark(minorTickMark)

Spécifie le type de graduation mineure pour l’axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickMark .

setMinorTickMark(minorTickMark: ChartAxisTickMark): void;

Paramètres

minorTickMark

ExcelScript.ChartAxisTickMark

Retourne

void

setMinorTimeUnitScale(minorTimeUnitScale)

Spécifie la valeur d’échelle d’unité mineure pour l’axe des catégories lorsque la propriété a la categoryType valeur dateAxis.

setMinorTimeUnitScale(minorTimeUnitScale: ChartAxisTimeUnit): void;

Paramètres

minorTimeUnitScale

ExcelScript.ChartAxisTimeUnit

Retourne

void

setMinorUnit(minorUnit)

Spécifie l’intervalle entre deux graduations mineures.

setMinorUnit(minorUnit: number): void;

Paramètres

minorUnit

number

Retourne

void

setMultiLevel(multiLevel)

Spécifie si un axe est multiniveau.

setMultiLevel(multiLevel: boolean): void;

Paramètres

multiLevel

boolean

Retourne

void

setNumberFormat(numberFormat)

Spécifie le code de format de l’étiquette de graduation de l’axe.

setNumberFormat(numberFormat: string): void;

Paramètres

numberFormat

string

Retourne

void

setOffset(offset)

Spécifie la distance entre les niveaux des étiquettes et la distance entre le premier niveau et la ligne d’axe. La valeur doit être un entier compris entre 0 et 1000.

setOffset(offset: number): void;

Paramètres

offset

number

Retourne

void

setPosition(position)

Spécifie la position d’axe spécifiée où l’autre axe se croise. Pour plus d’informations, consultez ExcelScript.ChartAxisPosition .

setPosition(position: ChartAxisPosition): void;

Paramètres

position

ExcelScript.ChartAxisPosition

Retourne

void

setPositionAt(value)

Définit la position d’axe spécifiée où l’autre axe se croise.

setPositionAt(value: number): void;

Paramètres

value

number

Valeur personnalisée du point de croisement.

Retourne

void

setReversePlotOrder(reversePlotOrder)

Spécifie si Excel trace les points de données du dernier au premier.

setReversePlotOrder(reversePlotOrder: boolean): void;

Paramètres

reversePlotOrder

boolean

Retourne

void

Exemples

/**
 * This sample reverses the plot order of the category axis.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the category axis to reverse the plot order.
  chart.getAxes().getCategoryAxis().setReversePlotOrder(true);
}

setScaleType(scaleType)

Spécifie le type d’échelle de l’axe des valeurs. Pour plus d’informations, consultez ExcelScript.ChartAxisScaleType .

setScaleType(scaleType: ChartAxisScaleType): void;

Paramètres

scaleType

ExcelScript.ChartAxisScaleType

Retourne

void

setShowDisplayUnitLabel(showDisplayUnitLabel)

Spécifie si l’étiquette d’unité d’affichage de l’axe est visible.

setShowDisplayUnitLabel(showDisplayUnitLabel: boolean): void;

Paramètres

showDisplayUnitLabel

boolean

Retourne

void

setTextOrientation(textOrientation)

Spécifie l’angle auquel le texte est orienté pour l’étiquette de graduation de l’axe 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

setTickLabelPosition(tickLabelPosition)

Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour plus d’informations, consultez ExcelScript.ChartAxisTickLabelPosition .

setTickLabelPosition(
            tickLabelPosition: ChartAxisTickLabelPosition
        ): void;

Paramètres

tickLabelPosition

ExcelScript.ChartAxisTickLabelPosition

Retourne

void

Exemples

/**
 * This sample sets the tick label position on the category axis.
 * This assumes the active worksheet has a chart.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the first chart on the active worksheet.
  const sheet = workbook.getActiveWorksheet();
  const chart = sheet.getCharts()[0];
  
  // Set the tick label position to low.
  chart.getAxes().getCategoryAxis().setTickLabelPosition(
    ExcelScript.ChartAxisTickLabelPosition.low
  );
}

setTickLabelSpacing(tickLabelSpacing)

Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation. Il peut s’agir d’une valeur comprise entre 1 et 31999.

setTickLabelSpacing(tickLabelSpacing: number): void;

Paramètres

tickLabelSpacing

number

Retourne

void

setTickMarkSpacing(tickMarkSpacing)

Spécifie le nombre de catégories ou de séries entre les graduations.

setTickMarkSpacing(tickMarkSpacing: number): void;

Paramètres

tickMarkSpacing

number

Retourne

void

setVisible(visible)

Spécifie si l’axe est visible.

setVisible(visible: boolean): void;

Paramètres

visible

boolean

Retourne

void