Excel. Chart Axis class

axisGroup

Spécifie le groupe de l’axe spécifié. Pour Excel.ChartAxisGroup plus de détails.

readonly axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";

Valeur de propriété

Excel.ChartAxisGroup | "Primary" | "Secondary"

Remarques

baseTimeUnit

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

baseTimeUnit: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

Valeur de propriété

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

Remarques

categoryType

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

categoryType: Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis";

Valeur de propriété

Excel.ChartAxisCategoryType | "Automatic" | "TextAxis" | "DateAxis"

Remarques

context

Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office.

context: RequestContext;

Valeur de propriété

Excel.RequestContext

customDisplayUnit

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

readonly customDisplayUnit: number;

Valeur de propriété

number

Remarques

displayUnit

Représente l’unité d’affichage de l’axe. Pour Excel.ChartAxisDisplayUnit plus de détails.

displayUnit: Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom";

Valeur de propriété

Remarques

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");

    let chart = sheet.charts.getItemAt(0);
    let categoryAxis = chart.axes.categoryAxis;
    let valueAxis = chart.axes.valueAxis;

    // Load to get display unit.
    valueAxis.load("displayUnit");

    await context.sync();

    console.log("The vertical axis display unit is: " + valueAxis.displayUnit);
});

format

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

readonly format: Excel.ChartAxisFormat;

Valeur de propriété

Excel.ChartAxisFormat

Remarques

height

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

readonly height: number;

Valeur de propriété

number

Remarques

isBetweenCategories

Indique si l’axe des valeurs croise l’axe des catégories entre les catégories.

isBetweenCategories: boolean;

Valeur de propriété

boolean

Remarques

left

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

readonly left: number;

Valeur de propriété

number

Remarques

linkNumberFormat

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

linkNumberFormat: boolean;

Valeur de propriété

boolean

Remarques

Jeu d’API : ExcelApi 1.9

logBase

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

logBase: number;

Valeur de propriété

number

Remarques

majorGridlines

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

readonly majorGridlines: Excel.ChartGridlines;

Valeur de propriété

Excel.ChartGridlines

Remarques

majorTickMark

Spécifie le type de graduation principale pour l’axe spécifié. Pour Excel.ChartAxisTickMark plus de détails.

majorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

Valeur de propriété

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

Remarques

majorTimeUnitScale

Spécifie la valeur d’échelle unitaire principale pour l’axe des catégories lorsque la categoryType propriété est définie sur dateAxis.

majorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

Valeur de propriété

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

Remarques

majorUnit

Représente l’intervalle entre deux graduations principales. Peut être défini sur une valeur numérique ou une chaîne vide. La valeur renvoyée est toujours un nombre.

majorUnit: any;

Valeur de propriété

any

Remarques

maximum

Représente la valeur maximale sur l’axe des ordonnées. Peut être défini sur une valeur numérique ou une chaîne vide (pour les valeurs d’axe automatique). La valeur renvoyée est toujours un nombre.

maximum: any;

Valeur de propriété

any

Remarques

minimum

Représente la valeur minimale sur l’axe des ordonnées. Peut être défini sur une valeur numérique ou une chaîne vide (pour les valeurs d’axe automatique). La valeur renvoyée est toujours un nombre.

minimum: any;

Valeur de propriété

any

Remarques

minorGridlines

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

readonly minorGridlines: Excel.ChartGridlines;

Valeur de propriété

Excel.ChartGridlines

Remarques

minorTickMark

Spécifie le type de graduation secondaire pour l’axe spécifié. Pour Excel.ChartAxisTickMark plus de détails.

minorTickMark: Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside";

Valeur de propriété

Excel.ChartAxisTickMark | "None" | "Cross" | "Inside" | "Outside"

Remarques

minorTimeUnitScale

Spécifie la valeur de l’échelle unitaire secondaire pour l’axe des catégories lorsque la categoryType propriété est définie sur dateAxis.

minorTimeUnitScale: Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years";

Valeur de propriété

Excel.ChartAxisTimeUnit | "Days" | "Months" | "Years"

Remarques

minorUnit

Représente l’intervalle entre deux graduations secondaires. Peut être défini sur une valeur numérique ou une chaîne vide (pour les valeurs d’axe automatique). La valeur renvoyée est toujours un nombre.

minorUnit: any;

Valeur de propriété

any

Remarques

multiLevel

Spécifie si un axe est à plusieurs niveaux.

multiLevel: boolean;

Valeur de propriété

boolean

Remarques

numberFormat

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

numberFormat: string;

Valeur de propriété

string

Remarques

offset

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

offset: number;

Valeur de propriété

number

Remarques

position

Spécifie la position de l’axe spécifiée à l’intersection de l’autre axe. Pour Excel.ChartAxisPosition plus de détails.

position: Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom";

Valeur de propriété

Excel.ChartAxisPosition | "Automatic" | "Maximum" | "Minimum" | "Custom"

Remarques

positionAt

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é.

readonly positionAt: number;

Valeur de propriété

number

Remarques

reversePlotOrder

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

reversePlotOrder: boolean;

Valeur de propriété

boolean

Remarques

scaleType

Spécifie le type d’échelle de l’axe des valeurs. Pour Excel.ChartAxisScaleType plus de détails.

scaleType: Excel.ChartAxisScaleType | "Linear" | "Logarithmic";

Valeur de propriété

Excel.ChartAxisScaleType | "Linear" | "Logarithmic"

Remarques

showDisplayUnitLabel

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

showDisplayUnitLabel: boolean;

Valeur de propriété

boolean

Remarques

Exemples

// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-axis.yaml

await Excel.run(async (context) => {
    const sheet = context.workbook.worksheets.getItem("Sample");
    let chart = sheet.charts.getItemAt(0);
    let axis = chart.axes.valueAxis;

    // Remove display unit.
    axis.showDisplayUnitLabel = false;

    await context.sync();
});

textOrientation

Spécifie l’angle d’orientation du texte 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.

textOrientation: any;

Valeur de propriété

any

Remarques

tickLabelPosition

Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour Excel.ChartAxisTickLabelPosition plus de détails.

tickLabelPosition: Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None";

Valeur de propriété

Excel.ChartAxisTickLabelPosition | "NextToAxis" | "High" | "Low" | "None"

Remarques

tickLabelSpacing

Spécifie le nombre de catégories ou de séries entre les étiquettes de graduation. Peut être une valeur de 1 à 31999 ou une chaîne vide pour le paramètre automatique. La valeur renvoyée est toujours un nombre.

tickLabelSpacing: any;

Valeur de propriété

any

Remarques

tickMarkSpacing

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

tickMarkSpacing: number;

Valeur de propriété

number

Remarques

title

Représente le titre de l’axe.

readonly title: Excel.ChartAxisTitle;

Valeur de propriété

Excel.ChartAxisTitle

Remarques

top

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

readonly top: number;

Valeur de propriété

number

Remarques

type

Spécifie le type d’axe. Pour Excel.ChartAxisType plus de détails.

readonly type: Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series";

Valeur de propriété

Excel.ChartAxisType | "Invalid" | "Category" | "Value" | "Series"

Remarques

visible

Indique si l’axe est visible.

visible: boolean;

Valeur de propriété

boolean

Remarques

width

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

readonly width: number;

Valeur de propriété

number

Remarques

load(options)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(options?: Excel.Interfaces.ChartAxisLoadOptions): Excel.ChartAxis;

Paramètres

options: Excel.Interfaces.ChartAxisLoadOptions

Fournit des options pour les propriétés de l’objet à charger.

Retours

Excel.ChartAxis

load(propertyNames)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNames?: string | string[]): Excel.ChartAxis;

Paramètres

propertyNames: string | string[]

Chaîne délimitée par des virgules ou tableau de chaînes spécifiant les propriétés à charger.

Retours

Excel.ChartAxis

Exemples

// Get the maximum of Chart Axis from Chart1.
await Excel.run(async (context) => { 
    const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");    
    const axis = chart.axes.valueAxis;
    axis.load('maximum');
    await context.sync();

    console.log(axis.maximum);
});

load(propertyNamesAndPaths)

Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter context.sync() avant de lire les propriétés.

load(propertyNamesAndPaths?: {
            select?: string;
            expand?: string;
        }): Excel.ChartAxis;

Paramètres

propertyNamesAndPaths: { select?: string; expand?: string; }

propertyNamesAndPaths.select est une chaîne délimitée par des virgules qui spécifie les propriétés à charger, et propertyNamesAndPaths.expand est une chaîne délimitée par des virgules qui spécifie les propriétés de navigation à charger.

Retours

Excel.ChartAxis

set(properties, options)

Définit plusieurs propriétés d’un objet en même temps. Vous pouvez transmettre soit un objet ordinaire avec les propriétés appropriées, soit un autre objet API du même type.

set(properties: Interfaces.ChartAxisUpdateData, options?: OfficeExtension.UpdateOptions): void;

Paramètres

properties: Excel.Interfaces.ChartAxisUpdateData

Objet JavaScript dont les propriétés sont structurées de façon isomorphe par rapport aux propriétés de l’objet sur lequel la méthode est appelée.

options: OfficeExtension.UpdateOptions

Fournit une option permettant de supprimer les erreurs si l’objet de propriétés tente de définir des propriétés en lecture seule.

Retours

void

set(properties)

Définit plusieurs propriétés sur l’objet en même temps, en fonction d’un objet chargé existant.

set(properties: Excel.ChartAxis): void;

Paramètres

properties: Excel.ChartAxis

Retours

void

setCategoryNames(sourceData)

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

setCategoryNames(sourceData: Range): void;

Paramètres

sourceData: Excel.Range

Objet Range correspondant aux données sources.

Retours

void

Remarques

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.

Retours

void

Remarques

setPositionAt(value)

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

setPositionAt(value: number): void;

Paramètres

value: number

Valeur personnalisée du point de croisement.

Retours

void

Remarques