Excel.ChartAxis class
Représente un axe unique dans un graphique.
- Extends
Remarques
[Jeu d’API : ExcelApi 1.1]
Propriétés
| alignment | Spécifie l’alignement de l’étiquette de graduation de l’axe spécifié. Voir |
| axis |
Spécifie le groupe de l’axe spécifié. Pour |
| base |
Spécifie l’unité de base pour l’axe des catégories spécifié. |
| category |
Spécifie le type d’axe des catégories. |
| context | Contexte de requête associé à l’objet. Cette opération connecte le processus du complément à celui de l’application hôte Office. |
| custom |
Spécifie la valeur de l’unité d’affichage de l’axe personnalisé. Pour définir cette propriété, veuillez utiliser la |
| display |
Représente l’unité d’affichage de l’axe. Pour |
| 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 |
| is |
Indique si l’axe des valeurs croise 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 du graphique. Retourne |
| link |
Spécifie si le format de nombre est lié aux cellules. Si |
| log |
Spécifie la base du logarithme lors de l’utilisation d’échelles logarithmiques. |
| major |
Renvoie un objet qui représente le quadrillage principal de l’axe spécifié. |
| major |
Spécifie le type de graduation principale pour l’axe spécifié. Pour |
| major |
Spécifie la valeur d’échelle unitaire principale pour l’axe des catégories lorsque la |
| major |
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. |
| minor |
Renvoie un objet qui représente le quadrillage secondaire de l’axe spécifié. |
| minor |
Spécifie le type de graduation secondaire pour l’axe spécifié. Pour |
| minor |
Spécifie la valeur de l’échelle unitaire secondaire pour l’axe des catégories lorsque la |
| minor |
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. |
| multi |
Spécifie si un axe est à plusieurs niveaux. |
| number |
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 de l’axe. La valeur doit être un entier compris entre 0 et 1000. |
| position | Spécifie la position de l’axe spécifiée à l’intersection de l’autre axe. Pour |
| position |
Spécifie la position de l’axe où l’autre axe se croise. Vous devez utiliser la |
| reverse |
Spécifie si Excel trace les points de données du dernier au premier. |
| scale |
Spécifie le type d’échelle de l’axe des valeurs. Pour |
| show |
Indique si l’étiquette de l’unité d’affichage de l’axe est visible. |
| text |
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. |
| tick |
Spécifie la position des étiquettes de graduation sur l'axe spécifié. Pour |
| tick |
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. |
| tick |
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 du graphique. Retourne |
| type | Spécifie le type d’axe. Pour |
| visible | Indique si l’axe est visible. |
| width | Spécifie la largeur, en points, de l’axe du graphique. Retourne |
Méthodes
| load(options) | Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| load(property |
Files d’attente de la commande pour charger les propriétés de l’objet spécifié. Vous devez contacter |
| 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) | Définit plusieurs propriétés sur l’objet en même temps, en fonction d’un objet chargé existant. |
| set |
Définit tous les noms de catégorie pour l’axe spécifié. |
| set |
Définit l’unité d’affichage axe sur une valeur personnalisée. |
| set |
Définit la position spécifiée de l’axe où l’autre axe se croise. |
| toJSON() | Remplace la méthode JavaScript |
Détails de la propriété
alignment
Spécifie l’alignement de l’étiquette de graduation de l’axe spécifié. Voir Excel.ChartTextHorizontalAlignment pour plus de détails.
alignment: Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right";
Valeur de propriété
Excel.ChartTickLabelAlignment | "Center" | "Left" | "Right"
Remarques
[Jeu d’API : ExcelApi 1.8]
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
[Jeu 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
[Jeu 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
[Jeu d’API : ExcelApi 1.7]
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é
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
[Jeu d’API : ExcelApi 1.7]
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é
Excel.ChartAxisDisplayUnit | "None" | "Hundreds" | "Thousands" | "TenThousands" | "HundredThousands" | "Millions" | "TenMillions" | "HundredMillions" | "Billions" | "Trillions" | "Custom"
Remarques
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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 du graphique. Retourne null si l’axe n’est pas visible.
readonly left: number;
Valeur de propriété
number
Remarques
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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
[Jeu d’API : ExcelApi 1.1]
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
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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
[Jeu 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
[Jeu 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
[Jeu 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
[Jeu d’API : ExcelApi 1.1]
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
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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
[Jeu d’API : ExcelApi 1.1]
multiLevel
Spécifie si un axe est à plusieurs niveaux.
multiLevel: boolean;
Valeur de propriété
boolean
Remarques
[Jeu 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
[Jeu 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 de l’axe. La valeur doit être un entier compris entre 0 et 1000.
offset: number;
Valeur de propriété
number
Remarques
[Jeu d’API : ExcelApi 1.8]
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
[Jeu 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
[Jeu 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
[Jeu d’API : ExcelApi 1.7]
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
[Jeu d’API : ExcelApi 1.7]
showDisplayUnitLabel
Indique si l’étiquette de l’unité d’affichage de l’axe est visible.
showDisplayUnitLabel: boolean;
Valeur de propriété
boolean
Remarques
[Jeu d’API : ExcelApi 1.7]
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
[Jeu d’API : ExcelApi 1.8]
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
[Jeu 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
[Jeu 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
[Jeu d’API : ExcelApi 1.7]
title
Représente le titre de l’axe.
readonly title: Excel.ChartAxisTitle;
Valeur de propriété
Remarques
[Jeu 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 du graphique. Retourne null si l’axe n’est pas visible.
readonly top: number;
Valeur de propriété
number
Remarques
[Jeu d’API : ExcelApi 1.7]
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
[Jeu d’API : ExcelApi 1.7]
visible
Indique si l’axe est visible.
visible: boolean;
Valeur de propriété
boolean
Remarques
[Jeu 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
[Jeu 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
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 spécifiant les propriétés à charger.
Retours
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 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
[Jeu 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
[Jeu d’API : ExcelApi 1.7]
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
[Jeu 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.stringify, à son tour, appelle 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 simple (typé ) Excel.Interfaces.ChartAxisDataqui contient des copies superficielles de toutes les propriétés enfants chargées à partir de l’objet d’origine.
toJSON(): Excel.Interfaces.ChartAxisData;