Partager via


Excel.ChartAxis class

Représente un axe unique dans un graphique.

Extends

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

Propriétés

alignment

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

axisGroup

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

baseTimeUnit

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

categoryType

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

context

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

customDisplayUnit

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

displayUnit

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

format

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

height

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

isBetweenCategories

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

left

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.

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.

logBase

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

majorGridlines

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

majorTickMark

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

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.

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.

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.

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.

minorGridlines

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

minorTickMark

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

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.

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.

multiLevel

Spécifie si un axe est multiniveau.

numberFormat

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

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.

position

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

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

reversePlotOrder

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

scaleType

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

showDisplayUnitLabel

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

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.

tickLabelPosition

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

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.

tickMarkSpacing

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

title

Représente le titre de l’axe.

top

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.

type

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

visible

Spécifie si l’axe est visible.

width

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

Méthodes

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

set(properties, options)

Définit plusieurs propriétés d’un objet en même temps. Vous pouvez passer un objet brut avec les propriétés appropriées ou un autre objet API du même type.

set(properties)

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

setCategoryNames(sourceData)

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

setCustomDisplayUnit(value)

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

setPositionAt(value)

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

toJSON()

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringifyappelle à son tour la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine Excel.ChartAxis est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant Excel.Interfaces.ChartAxisDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

Détails de la propriété

alignment

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

alignment: Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right";

Valeur de propriété

Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right"

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

axisGroup

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

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

Valeur de propriété

Excel.ChartAxisGroup | "Primary" | "Secondary"

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

context

Contexte de requête associé à l’objet . Cela connecte le processus du complément au processus de l’application hôte Office.

context: RequestContext;

Valeur de propriété

customDisplayUnit

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

readonly customDisplayUnit: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

displayUnit

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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é

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

isBetweenCategories

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

isBetweenCategories: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

left

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.

readonly left: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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.

linkNumberFormat: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble 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

[ Ensemble d’API : ExcelApi 1.7 ]

majorGridlines

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

readonly majorGridlines: Excel.ChartGridlines;

Valeur de propriété

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

majorTickMark

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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.

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.1 ]

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

[ Ensemble d’API : ExcelApi 1.1 ]

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

[ Ensemble d’API : ExcelApi 1.1 ]

minorGridlines

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

readonly minorGridlines: Excel.ChartGridlines;

Valeur de propriété

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

minorTickMark

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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.

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.1 ]

multiLevel

Spécifie si un axe est multiniveau.

multiLevel: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

numberFormat

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

numberFormat: string;

Valeur de propriété

string

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

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.

offset: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

position

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

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

[ Ensemble d’API : ExcelApi 1.8 ]

reversePlotOrder

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

reversePlotOrder: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

scaleType

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

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

Valeur de propriété

Excel.ChartAxisScaleType | "Linear" | "Logarithmic"

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

showDisplayUnitLabel

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

showDisplayUnitLabel: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

textOrientation: any;

Valeur de propriété

any

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

tickLabelPosition

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

tickMarkSpacing

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

tickMarkSpacing: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

title

Représente le titre de l’axe.

readonly title: Excel.ChartAxisTitle;

Valeur de propriété

Remarques

[ Ensemble d’API : ExcelApi 1.1 ]

top

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.

readonly top: number;

Valeur de propriété

number

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

type

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

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

Valeur de propriété

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

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

visible

Spécifie si l’axe est visible.

visible: boolean;

Valeur de propriété

boolean

Remarques

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

Détails de la méthode

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

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 qui spécifient les propriétés à charger.

Retours

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

set(properties, options)

Définit plusieurs propriétés d’un objet en même temps. Vous pouvez passer un objet brut avec les propriétés appropriées ou un autre objet API du même type.

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

Paramètres

properties
Excel.Interfaces.ChartAxisUpdateData

Objet JavaScript avec des propriétés qui sont structurées isomorphes en fonction des 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 properties 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

[ Ensemble d’API : ExcelApi 1.7 ]

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

[ Ensemble d’API : ExcelApi 1.7 ]

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.

Retours

void

Remarques

[ Ensemble d’API : ExcelApi 1.8 ]

toJSON()

Remplace la méthode JavaScript toJSON() afin de fournir une sortie plus utile lorsqu’un objet API est passé à JSON.stringify(). (JSON.stringifyappelle à son tour la toJSON méthode de l’objet qui lui est passé.) Alors que l’objet d’origine Excel.ChartAxis est un objet API, la toJSON méthode renvoie un objet JavaScript brut (typé en tant Excel.Interfaces.ChartAxisDataque ) qui contient des copies superficielles de toutes les propriétés enfants chargées de l’objet d’origine.

toJSON(): Excel.Interfaces.ChartAxisData;

Retours