Excel.ChartSeries class

Stellt eine Datenreihe in einem Diagramm dar.

Extends

Hinweise

[ API-Satz: ExcelApi 1.1 ]

Eigenschaften

axisGroup

Gibt die Gruppe für die angegebene Reihe an.

binOptions

Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme.

boxwhiskerOptions

Verkapselt die Optionen für Kastengrafikdiagramme.

bubbleScale

Dies kann ein ganzzahliger Wert von 0 (null) bis 300 sein, der einem Prozentsatz der Standardgröße darstellt. Diese Eigenschaft gilt nur für Blasendiagramme.

chartType

Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter Excel.ChartType .

context

Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

dataLabels

Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.

doughnutHoleSize

Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen InvalidArgument Fehler bei ungültigen Diagrammen aus.

explosion

Gibt den Explosionswert für ein Kreisdiagramm- oder Ringdiagrammsegment an. Gibt 0 (null) zurück, wenn keine Explosion vorliegt (die Spitze des Segments befindet sich in der Mitte des Kreisdiagramms).

filtered

Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme.

firstSliceAngle

Gibt den Winkel des ersten Kreisdiagramm- oder Ringdiagrammsegments in Grad an (im Uhrzeigersinn ab vertikal). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme. Dies kann ein Wert von 0 bis 360 sein.

format

Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung.

gapWidth

Stellt die Abstandsbreite einer Diagrammreihe dar. Nur gültig für Balken- und Säulendiagramme sowie bestimmte Klassen von Linien- und Kreisdiagrammen. Löst eine Ausnahme für ungültige Argumente für ungültige Diagramme aus.

gradientMaximumColor

Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an.

gradientMaximumType

Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an.

gradientMaximumValue

Gibt den Maximalwert einer Regionsdiagrammreihe an.

gradientMidpointColor

Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an.

gradientMidpointType

Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an.

gradientMidpointValue

Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.

gradientMinimumColor

Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an.

gradientMinimumType

Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an.

gradientMinimumValue

Gibt den Mindestwert einer Regionsdiagrammreihe an.

gradientStyle

Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.

hasDataLabels

Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt.

invertColor

Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an.

invertIfNegative

True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht.

mapOptions

Verkapselt die Optionen für ein Bereichsdiagramm.

markerBackgroundColor

Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.

markerForegroundColor

Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.

markerSize

Gibt die Markergröße einer Diagrammreihe an. Der unterstützte Größenbereich beträgt 2 bis 72. Diese Methode gibt einen InvalidArgument-Fehler zurück, wenn sie mit einer Größe außerhalb des unterstützten Bereichs festgelegt ist.

markerStyle

Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter Excel.ChartMarkerStyle .

name

Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein.

overlap

Gibt an, wie Balken und Spalten angeordnet sind. Dies kann ein Wert zwischen –100 und 100 sein. Gilt nur für 2D-Balken- und 2D-Säulendiagramme.

parentLabelStrategy

Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an.

plotOrder

Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.

points

Gibt eine Auflistung aller Punkte in der Reihe zurück.

secondPlotSize

Gibt die Größe des sekundären Abschnitts eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms als Prozentsatz der Größe des primären Kreises an. Dies kann ein Wert von 5 bis 200 sein.

showConnectorLines

Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.

showLeaderLines

Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden.

showShadow

Gibt an, ob die Reihe einen Schatten aufweist.

smooth

Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme.

splitType

Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden.

splitValue

Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt.

trendlines

Die Auflistung der Trendlinien in der Reihe.

varyByCategories

True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten.

xErrorBars

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

yErrorBars

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

Methoden

delete()

Löscht die Diagrammreihen.

getDimensionDataSourceString(dimension)

Ruft die Zeichenfolgendarstellung der Datenquelle der Diagrammreihe ab. Bei der Zeichenfolgendarstellung kann es sich um Informationen wie eine Zellenadresse handeln.

getDimensionDataSourceString(dimensionString)

Ruft die Zeichenfolgendarstellung der Datenquelle der Diagrammreihe ab. Bei der Zeichenfolgendarstellung kann es sich um Informationen wie eine Zellenadresse handeln.

getDimensionDataSourceType(dimension)

Ruft den Datenquellentyp der Diagrammreihe ab.

getDimensionDataSourceType(dimensionString)

Ruft den Datenquellentyp der Diagrammreihe ab.

getDimensionValues(dimension)

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dies können entweder Kategoriewerte oder Datenwerte sein, abhängig von der angegebenen Dimension und der Zuordnung der Daten für die Diagrammreihe.

getDimensionValues(dimensionString)

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dies können entweder Kategoriewerte oder Datenwerte sein, abhängig von der angegebenen Dimension und der Zuordnung der Daten für die Diagrammreihe.

load(options)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNames)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(propertyNamesAndPaths)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

set(properties, options)

Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.

set(properties)

Legt mehrere Eigenschaften für das -Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.

setBubbleSizes(sourceData)

Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme.

setValues(sourceData)

Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse.

setXAxisValues(sourceData)

Legt die Werte der X-Achse für eine Diagrammreihe fest.

toJSON()

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON -Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Excel.ChartSeries Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als Excel.Interfaces.ChartSeriesData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

Details zur Eigenschaft

axisGroup

Gibt die Gruppe für die angegebene Reihe an.

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

Eigenschaftswert

Excel.ChartAxisGroup | "Primary" | "Secondary"

Hinweise

[ API-Satz: ExcelApi 1.8 ]

binOptions

Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme.

readonly binOptions: Excel.ChartBinOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.9 ]

boxwhiskerOptions

Verkapselt die Optionen für Kastengrafikdiagramme.

readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.9 ]

bubbleScale

Dies kann ein ganzzahliger Wert von 0 (null) bis 300 sein, der einem Prozentsatz der Standardgröße darstellt. Diese Eigenschaft gilt nur für Blasendiagramme.

bubbleScale: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.9 ]

chartType

Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter Excel.ChartType .

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";

Eigenschaftswert

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"

Hinweise

[ API-Satz: ExcelApi 1.7 ]

context

Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.

context: RequestContext;

Eigenschaftswert

dataLabels

Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.

readonly dataLabels: Excel.ChartDataLabels;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.8 ]

doughnutHoleSize

Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen InvalidArgument Fehler bei ungültigen Diagrammen aus.

doughnutHoleSize: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.7 ]

explosion

Gibt den Explosionswert für ein Kreisdiagramm- oder Ringdiagrammsegment an. Gibt 0 (null) zurück, wenn keine Explosion vorliegt (die Spitze des Segments befindet sich in der Mitte des Kreisdiagramms).

explosion: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.8 ]

filtered

Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme.

filtered: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

firstSliceAngle

Gibt den Winkel des ersten Kreisdiagramm- oder Ringdiagrammsegments in Grad an (im Uhrzeigersinn ab vertikal). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme. Dies kann ein Wert von 0 bis 360 sein.

firstSliceAngle: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.8 ]

format

Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung.

readonly format: Excel.ChartSeriesFormat;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.1 ]

gapWidth

Stellt die Abstandsbreite einer Diagrammreihe dar. Nur gültig für Balken- und Säulendiagramme sowie bestimmte Klassen von Linien- und Kreisdiagrammen. Löst eine Ausnahme für ungültige Argumente für ungültige Diagramme aus.

gapWidth: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.7 ]

gradientMaximumColor

Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an.

gradientMaximumColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMaximumType

Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an.

gradientMaximumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Eigenschaftswert

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMaximumValue

Gibt den Maximalwert einer Regionsdiagrammreihe an.

gradientMaximumValue: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMidpointColor

Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an.

gradientMidpointColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMidpointType

Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an.

gradientMidpointType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Eigenschaftswert

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMidpointValue

Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.

gradientMidpointValue: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMinimumColor

Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an.

gradientMinimumColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMinimumType

Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an.

gradientMinimumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";

Eigenschaftswert

Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientMinimumValue

Gibt den Mindestwert einer Regionsdiagrammreihe an.

gradientMinimumValue: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.9 ]

gradientStyle

Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.

gradientStyle: Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor";

Eigenschaftswert

Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor"

Hinweise

[ API-Satz: ExcelApi 1.9 ]

hasDataLabels

Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt.

hasDataLabels: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

invertColor

Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an.

invertColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.9 ]

invertIfNegative

True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht.

invertIfNegative: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.8 ]

mapOptions

Verkapselt die Optionen für ein Bereichsdiagramm.

readonly mapOptions: Excel.ChartMapOptions;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.9 ]

markerBackgroundColor

Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.

markerBackgroundColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerForegroundColor

Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.

markerForegroundColor: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerSize

Gibt die Markergröße einer Diagrammreihe an. Der unterstützte Größenbereich beträgt 2 bis 72. Diese Methode gibt einen InvalidArgument-Fehler zurück, wenn sie mit einer Größe außerhalb des unterstützten Bereichs festgelegt ist.

markerSize: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

markerStyle

Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter Excel.ChartMarkerStyle .

markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";

Eigenschaftswert

Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
    let sheet = context.workbook.worksheets.getItem("Sample");
    let salesTable = sheet.tables.getItem("SalesTable");
    let dataRange = sheet.getRange("A1:E7");

    // Create an XY scatter chart.
    let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
    chart.title.text = "Bicycle Parts Quarterly Sales"; 
  
    let series = chart.series;
    let series0 = series.getItemAt(0);
    let series1 = series.getItemAt(1);
    let series2 = series.getItemAt(2);
    let series3 = series.getItemAt(3);

    // Set markers.
    series0.markerStyle = "Dash";
    series0.markerForegroundColor = "black";
    series1.markerStyle = "Star";
    series1.markerForegroundColor = "black";
    series2.markerStyle = "X";
    series2.markerSize = 12;
    series3.markerStyle = "Triangle";
    series3.markerBackgroundColor = "purple";

    await context.sync();
});

name

Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein.

name: string;

Eigenschaftswert

string

Hinweise

[ API-Satz: ExcelApi 1.1 ]

overlap

Gibt an, wie Balken und Spalten angeordnet sind. Dies kann ein Wert zwischen –100 und 100 sein. Gilt nur für 2D-Balken- und 2D-Säulendiagramme.

overlap: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.8 ]

parentLabelStrategy

Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an.

parentLabelStrategy: Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping";

Eigenschaftswert

Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping"

Hinweise

[ API-Satz: ExcelApi 1.9 ]

plotOrder

Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.

plotOrder: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.7 ]

points

Gibt eine Auflistung aller Punkte in der Reihe zurück.

readonly points: Excel.ChartPointsCollection;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.1 ]

secondPlotSize

Gibt die Größe des sekundären Abschnitts eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms als Prozentsatz der Größe des primären Kreises an. Dies kann ein Wert von 5 bis 200 sein.

secondPlotSize: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.8 ]

showConnectorLines

Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.

showConnectorLines: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

showLeaderLines

Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden.

showLeaderLines: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.9 ]

showShadow

Gibt an, ob die Reihe einen Schatten aufweist.

showShadow: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

smooth

Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme.

smooth: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.7 ]

splitType

Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden.

splitType: Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit";

Eigenschaftswert

Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit"

Hinweise

[ API-Satz: ExcelApi 1.8 ]

splitValue

Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt.

splitValue: number;

Eigenschaftswert

number

Hinweise

[ API-Satz: ExcelApi 1.9 ]

trendlines

Die Auflistung der Trendlinien in der Reihe.

readonly trendlines: Excel.ChartTrendlineCollection;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.7 ]

varyByCategories

True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten.

varyByCategories: boolean;

Eigenschaftswert

boolean

Hinweise

[ API-Satz: ExcelApi 1.8 ]

xErrorBars

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

readonly xErrorBars: Excel.ChartErrorBars;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.9 ]

yErrorBars

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

readonly yErrorBars: Excel.ChartErrorBars;

Eigenschaftswert

Hinweise

[ API-Satz: ExcelApi 1.9 ]

Details zur Methode

delete()

Löscht die Diagrammreihen.

delete(): void;

Gibt zurück

void

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sample");
  const seriesCollection = sheet.charts.getItemAt(0).series;
  seriesCollection.load("count");
  await context.sync();

  if (seriesCollection.count > 0) {
    const series = seriesCollection.getItemAt(0);

    // Delete the first series.
    series.delete();
  }

  await context.sync();
});

getDimensionDataSourceString(dimension)

Ruft die Zeichenfolgendarstellung der Datenquelle der Diagrammreihe ab. Bei der Zeichenfolgendarstellung kann es sich um Informationen wie eine Zellenadresse handeln.

getDimensionDataSourceString(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string>;

Parameter

dimension
Excel.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.15 ]

Beispiele

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

// This function retrieves the data source information of a chart series in the Sample worksheet.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sample");

  // Get the first chart series from the first chart on the worksheet.
  const seriesCollection = sheet.charts.getItemAt(0).series;
  const series = seriesCollection.getItemAt(0);

  // Get the series data source string and type values. 
  const dataSourceString = series.getDimensionDataSourceString("Values");
  const dataSourceType = series.getDimensionDataSourceType("Values");

  series.load("name");
  await context.sync();
  
  // Log the data source information to the console.
  console.log(series.name + " data source string: " + dataSourceString.value);
  console.log(series.name + " data source type: " + dataSourceType.value);
});

getDimensionDataSourceString(dimensionString)

Ruft die Zeichenfolgendarstellung der Datenquelle der Diagrammreihe ab. Bei der Zeichenfolgendarstellung kann es sich um Informationen wie eine Zellenadresse handeln.

getDimensionDataSourceString(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string>;

Parameter

dimensionString

"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.15 ]

getDimensionDataSourceType(dimension)

Ruft den Datenquellentyp der Diagrammreihe ab.

getDimensionDataSourceType(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

Parameter

dimension
Excel.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.15 ]

Beispiele

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

// This function retrieves the data source information of a chart series in the Sample worksheet.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem("Sample");

  // Get the first chart series from the first chart on the worksheet.
  const seriesCollection = sheet.charts.getItemAt(0).series;
  const series = seriesCollection.getItemAt(0);

  // Get the series data source string and type values. 
  const dataSourceString = series.getDimensionDataSourceString("Values");
  const dataSourceType = series.getDimensionDataSourceType("Values");

  series.load("name");
  await context.sync();
  
  // Log the data source information to the console.
  console.log(series.name + " data source string: " + dataSourceString.value);
  console.log(series.name + " data source type: " + dataSourceType.value);
});

getDimensionDataSourceType(dimensionString)

Ruft den Datenquellentyp der Diagrammreihe ab.

getDimensionDataSourceType(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<Excel.ChartDataSourceType>;

Parameter

dimensionString

"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.15 ]

getDimensionValues(dimension)

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dies können entweder Kategoriewerte oder Datenwerte sein, abhängig von der angegebenen Dimension und der Zuordnung der Daten für die Diagrammreihe.

getDimensionValues(dimension: Excel.ChartSeriesDimension): OfficeExtension.ClientResult<string[]>;

Parameter

dimension
Excel.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.12 ]

Beispiele

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

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

  // The sample chart is of type `Excel.ChartType.bubble`.
  const bubbleChart = sheet.charts.getItem("Product Chart");

  // Get the first series in the chart.
  const firstSeries = bubbleChart.series.getItemAt(0);

  // Get the values for the dimensions we're interested in.
  const bubbleSize = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.bubbleSizes);
  const xValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.xvalues);
  const yValues = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.yvalues);
  const category = firstSeries.getDimensionValues(Excel.ChartSeriesDimension.categories);

  await context.sync();

  // Log the information.
  console.log(`Series ${category.value} - X:${xValues.value},Y:${yValues.value},Bubble:${bubbleSize.value}`);
});

getDimensionValues(dimensionString)

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dies können entweder Kategoriewerte oder Datenwerte sein, abhängig von der angegebenen Dimension und der Zuordnung der Daten für die Diagrammreihe.

getDimensionValues(dimensionString: "Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"): OfficeExtension.ClientResult<string[]>;

Parameter

dimensionString

"Categories" | "Values" | "XValues" | "YValues" | "BubbleSizes"

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

Hinweise

[ API-Satz: ExcelApi 1.12 ]

load(options)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

load(options?: Excel.Interfaces.ChartSeriesLoadOptions): Excel.ChartSeries;

Parameter

options
Excel.Interfaces.ChartSeriesLoadOptions

Stellt Optionen dafür bereit, welche Eigenschaften des -Objekts geladen werden sollen.

Gibt zurück

load(propertyNames)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

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

Parameter

propertyNames

string | string[]

Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.

Gibt zurück

Beispiele

// Rename the 1st series of Chart1 to "New Series Name".
await Excel.run(async (context) => { 
    const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");    
    chart.series.getItemAt(0).name = "New Series Name";
    await context.sync();

    console.log("Series1 Renamed");
});

load(propertyNamesAndPaths)

Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()" aufrufen.

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

Parameter

propertyNamesAndPaths

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

propertyNamesAndPaths.select ist eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.

Gibt zurück

set(properties, options)

Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.

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

Parameter

properties
Excel.Interfaces.ChartSeriesUpdateData

Ein JavaScript-Objekt mit Eigenschaften, die isomorph zu den Eigenschaften des Objekts strukturiert sind, für das die Methode aufgerufen wird.

options
OfficeExtension.UpdateOptions

Stellt eine Option zum Unterdrücken von Fehlern bereit, wenn das Eigenschaftenobjekt versucht, schreibgeschützte Eigenschaften festzulegen.

Gibt zurück

void

set(properties)

Legt mehrere Eigenschaften für das -Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.

set(properties: Excel.ChartSeries): void;

Parameter

properties
Excel.ChartSeries

Gibt zurück

void

setBubbleSizes(sourceData)

Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme.

setBubbleSizes(sourceData: Range): void;

Parameter

sourceData
Excel.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

await Excel.run(async (context) => {
  /*
    The table is expected to look like this:
    Product, Inventory, Price, Current Market Share
    Calamansi, 2000, $2.45, 10%
    ...

    We want each bubble to represent a single row.
  */

  // Get the worksheet and table data.
  const sheet = context.workbook.worksheets.getItem("Sample");
  const table = sheet.tables.getItem("Sales");
  const dataRange = table.getDataBodyRange();

  // Get the table data without the row names.
  const valueRange = dataRange.getOffsetRange(0, 1).getResizedRange(0, -1);

  // Create the chart.
  const bubbleChart = sheet.charts.add(Excel.ChartType.bubble, valueRange);
  bubbleChart.name = "Product Chart";

  // Remove the default series, since we want a unique series for each row.
  bubbleChart.series.getItemAt(0).delete();

  // Load the data necessary to make a chart series.
  dataRange.load(["rowCount", "values"]);
  await context.sync();

  // For each row, create a chart series (a bubble).
  for (let i = 0; i < dataRange.rowCount; i++) {
    const newSeries = bubbleChart.series.add(dataRange.values[i][0], i);
    newSeries.setXAxisValues(dataRange.getCell(i, 1));
    newSeries.setValues(dataRange.getCell(i, 2));
    newSeries.setBubbleSizes(dataRange.getCell(i, 3));

    // Show the product name and market share percentage.
    newSeries.dataLabels.showSeriesName = true;
    newSeries.dataLabels.showBubbleSize = true;
    newSeries.dataLabels.showValue = false;
  }

  await context.sync();
});

setValues(sourceData)

Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse.

setValues(sourceData: Range): void;

Parameter

sourceData
Excel.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void

Hinweise

[ API-Satz: ExcelApi 1.7 ]

Beispiele

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

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

  let seriesCollection = sheet.charts.getItemAt(0);
  let rangeSelection = sheet.getRange("C2:C7");
  let xRangeSelection = sheet.getRange("A1:A7");

  // Add a series.
  let newSeries = seriesCollection.series.add("Qtr2");
  newSeries.setValues(rangeSelection);
  newSeries.setXAxisValues(xRangeSelection);

  await context.sync();
});

setXAxisValues(sourceData)

Legt die Werte der X-Achse für eine Diagrammreihe fest.

setXAxisValues(sourceData: Range): void;

Parameter

sourceData
Excel.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void

Hinweise

[ API-Satz: ExcelApi 1.7 ]

toJSON()

Überschreibt die JavaScript-Methode toJSON() , um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()übergeben wird. (JSON.stringifyruft wiederum die toJSON -Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Excel.ChartSeries Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (typisiert als Excel.Interfaces.ChartSeriesData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.

toJSON(): Excel.Interfaces.ChartSeriesData;

Gibt zurück