Excel.Chart class

Représente les axes du graphique.

readonly axes: Excel.ChartAxes;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie une constante d’énumération de niveau d’étiquette de catégorie de graphique, faisant référence au niveau des étiquettes de catégorie source.

categoryLabelLevel: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Spécifie le type du graphique. Pour Excel.ChartType plus de détails.

chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.7]

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é

Représente les étiquettes des données sur le graphique.

readonly dataLabels: Excel.ChartDataLabels;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie la manière dont les cellules vides sont tracées sur un graphique.

displayBlanksAs: Excel.ChartDisplayBlanksAs | "NotPlotted" | "Zero" | "Interplotted";

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Regroupe les propriétés de format de la zone de graphique.

readonly format: Excel.ChartAreaFormat;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie la hauteur, en points, de l’objet graphique.

height: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

L’ID unique du graphique.

readonly id: string;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.7]

La distance, en points, entre le côté gauche du graphique et l’origine de la feuille de calcul.

left: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Représente la légende du graphique.

readonly legend: Excel.ChartLegend;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie le nom d’un objet graphique.

name: string;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Encapsule les options pour le graphique croisé dynamique.

readonly pivotOptions: Excel.ChartPivotOptions;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.9]

Représente la zone de traçage du graphique.

readonly plotArea: Excel.ChartPlotArea;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Spécifie la façon dont les colonnes ou les lignes sont utilisées comme séries de données sur le graphique.

plotBy: Excel.ChartPlotBy | "Rows" | "Columns";

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Vrai si seules les cellules visibles sont tracées. Faux si les deux cellules visibles et masquées sont tracées.

plotVisibleOnly: boolean;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Représente une série ou une collection de séries dans le graphique.

readonly series: Excel.ChartSeriesCollection;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie une constante d’énumération de niveau de nom de série de graphiques, faisant référence au niveau des noms de série source.

seriesNameLevel: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Indique si tous les boutons de champ doivent être affichés dans un graphique croisé dynamique.

showAllFieldButtons: boolean;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.7]

Indique si les étiquettes de données doivent être affichées lorsque la valeur est supérieure à la valeur maximale sur l’axe des valeurs. Si l’axe des valeurs devient plus petit que la taille des points de données, vous pouvez utiliser cette propriété pour définir si les étiquettes de données doivent être affichées. Cette propriété s'applique uniquement aux graphiques 2D.

showDataLabelsOverMaximum: boolean;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Spécifie le style de graphique du graphique.

style: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.8]

Représente le titre du graphique indiqué et comprend le texte, la visibilité, la position et la mise en forme du titre.

readonly title: Excel.ChartTitle;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie la distance, en points, entre le bord supérieur de l’objet et le haut de la ligne 1 (sur une feuille de calcul) ou le haut de la zone de graphique (sur un graphique).

top: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Spécifie la largeur, en points, de l’objet graphique.

width: number;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.1]

Feuille de calcul contenant le graphique actuel.

readonly worksheet: Excel.Worksheet;

Valeur de propriété

Remarques

[Jeu d’API : ExcelApi 1.2]

Active le graphique dans l’interface utilisateur Excel.

activate(): void;

Retours

Remarques

[Jeu d’API : ExcelApi 1.9]

Supprime l’objet de graphique.

delete(): void;

Retours

Remarques

[Jeu d’API : ExcelApi 1.1]

Obtient la table de données sur le graphique. Si le graphique n’autorise pas une table de données, il lève une exception.

getDataTable(): Excel.ChartDataTable;

Retours

Remarques

[Jeu d’API : ExcelApi 1.14]

Obtient la table de données sur le graphique. Si le graphique n’autorise pas une table de données, cette méthode renvoie un objet dont la isNullObject propriété est définie sur true. Pour plus d’informations, consultez * Méthodes et propriétés d’OrNullObject.

getDataTableOrNullObject(): Excel.ChartDataTable;

Retours

Remarques

[Jeu d’API : ExcelApi 1.14]

Affiche le graphique sous la forme d’une image codée en Base64 en mettant à l’échelle le graphique pour l’adapter aux dimensions spécifiées. Les proportions sont conservées dans le cadre du redimensionnement.

getImage(width?: number, height?: number, fittingMode?: Excel.ImageFittingMode): OfficeExtension.ClientResult<string>;

Paramètres

Retours

Remarques

[Jeu d’API : ExcelApi 1.2]

Affiche le graphique sous la forme d’une image codée en Base64 en mettant à l’échelle le graphique pour l’adapter aux dimensions spécifiées. Les proportions sont conservées dans le cadre du redimensionnement.

getImage(width?: number, height?: number, fittingMode?: "Fit" | "FitAndCenter" | "Fill"): OfficeExtension.ClientResult<string>;

Paramètres

Retours

Remarques

[Jeu d’API : ExcelApi 1.2]

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.ChartLoadOptions): Excel.Chart;

Paramètres

Retours

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

Paramètres

Retours

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

Paramètres

Retours

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.ChartUpdateData, options?: OfficeExtension.UpdateOptions): void;

Paramètres

Retours

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

set(properties: Excel.Chart): void;

Paramètres

Retours

Redéfinit les données sources du graphique.

setData(sourceData: Range, seriesBy?: Excel.ChartSeriesBy): void;

Paramètres

Retours

Remarques

[Jeu d’API : ExcelApi 1.1]

Redéfinit les données sources du graphique.

setData(sourceData: Range, seriesBy?: "Auto" | "Columns" | "Rows"): void;

Paramètres

Retours

Remarques

[Jeu d’API : ExcelApi 1.1]

Positionne le graphique par rapport aux cellules dans la feuille de calcul.

setPosition(startCell: Range | string, endCell?: Range | string): void;

Paramètres

Retours

Remarques

[Jeu d’API : ExcelApi 1.1]

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.Chart est un objet API, la toJSON méthode renvoie un objet JavaScript simple (typé ) Excel.Interfaces.ChartDataqui contient des copies superficielles de toutes les propriétés enfants chargées à partir de l’objet d’origine.

toJSON(): Excel.Interfaces.ChartData;

Retours

Se produit lorsque le graphique est activé.

readonly onActivated: OfficeExtension.EventHandlers<Excel.ChartActivatedEventArgs>;

Type d’événement

Remarques

[Jeu d’API : ExcelApi 1.8]

Se produit lorsque le graphique est désactivé.

readonly onDeactivated: OfficeExtension.EventHandlers<Excel.ChartDeactivatedEventArgs>;

Type d’événement

Remarques

[Jeu d’API : ExcelApi 1.8]