Excel.ChartSeries class

Gibt die Gruppe für die angegebene Reihe an.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

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

readonly binOptions: Excel.ChartBinOptions;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Verkapselt die Optionen für Kastengrafikdiagramme.

readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

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

Hinweise

API-Satz: ExcelApi 1.9

Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen findest du hier 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" | "ColumnClusteredEx" | "ColumnStackedEx" | "ColumnStacked100Ex" | "LineEx" | "LineStackedEx" | "LineStacked100Ex" | "PieEx" | "DoughnutEx" | "BarClusteredEx" | "BarStackedEx" | "BarStacked100Ex" | "AreaEx" | "AreaStackedEx" | "AreaStacked100Ex" | "XYScatterEx" | "BubbleEx";

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

context: RequestContext;

Eigenschaftswert

Stellt eine Sammlung aller Datenbezeichnungen in der Datenreihe dar.

readonly dataLabels: Excel.ChartDataLabels;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

Stellt die Innenringgröße einer Diagrammreihe dar. Nur gültig für Ringdiagramme und Donut-Explosionsdiagramme. Gibt einen InvalidArgument Fehler bei ungültigen Diagrammen aus.

doughnutHoleSize: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Gibt den Explosionswert für ein Kreisdiagramm oder ein 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

Hinweise

API-Satz: ExcelApi 1.8

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

filtered: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

firstSliceAngle: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

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

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

gapWidth: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

Gibt die Farbe für den Maximalwert einer Regionskarten-Diagrammserie an.

gradientMaximumColor: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Typ für den Maximalwert einer Diagrammserie mit Regionskarte an.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den maximalen Wert einer Diagrammserie mit Regionskarte an.

gradientMaximumValue: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt die Farbe für den Mittelpunkt einer Diagrammserie einer Regionskarte an.

gradientMidpointColor: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Typ für den Mittelpunkt einer Diagrammserie mit einer Regionskarte an.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Mittelpunkt einer Diagrammserie mit Regionskarte an.

gradientMidpointValue: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt die Farbe für den Minimalwert einer Regionskarten-Diagrammserie an.

gradientMinimumColor: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Typ für den Minimalwert einer Diagrammserie mit Regionskarte an.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt den Minimalwert einer Diagrammserie mit Regionskarte an.

gradientMinimumValue: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Legt den Serienverlaufsstil eines Diagramms der Regionskarte fest.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt an, ob die Reihe Datenbeschriftungen enthält.

hasDataLabels: boolean;

Eigenschaftswert

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-leader-lines.yaml

// The following code adds data labels to the chart and positions them to demonstrate leader lines.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem(sheetName);
  const chart = sheet.charts.getItemAt(0);
  const series = chart.series.getItemAt(0);
  
  // Enable data labels for the series. Leader lines are enabled by default.
  series.hasDataLabels = true;
  series.points.load("items");
  await context.sync();
  
  // Load the top position for each data label.
  series.points.items.forEach((point) => point.dataLabel.load("top"));
  await context.sync();

  // Move some data labels to create distance from their chart points.
  const point1 = series.points.items[1]; 
  const point2 = series.points.items[2]; 
  point1.dataLabel.top -= 50; 
  point2.dataLabel.top += 50;
  
  // Format the data labels.
  series.dataLabels.geometricShapeType = Excel.GeometricShapeType.rectangle;
  series.dataLabels.showCategoryName = true;
  series.dataLabels.format.border.weight = 1;
  
  await context.sync();
});

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

invertColor: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

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

invertIfNegative: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

Verkapselt die Optionen für ein Bereichsdiagramm.

readonly mapOptions: Excel.ChartMapOptions;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt die Hintergrundfarbe der Markierung einer Diagrammreihe an.

markerBackgroundColor: string;

Eigenschaftswert

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();
});

Gibt die Markierungsfarbe für den Vordergrund einer Diagrammserie an.

markerForegroundColor: string;

Eigenschaftswert

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();
});

Gibt die Markierungsgröße einer Diagrammreihe an. Der unterstützte Größenbereich liegt zwischen 2 und 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

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();
});

Gibt das Markierungsformat einer Diagrammserie an. Weitere Informationen findest du hier Excel.ChartMarkerStyle .

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

Eigenschaftswert

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();
});

Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens sollte nicht mehr als 255 Zeichen betragen.

name: string;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.1

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

Hinweise

API-Satz: ExcelApi 1.8

Gibt den Strategiebereich für übergeordnete Beschriftungen der Serie für ein Treemap-Diagramm an.

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

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt die Darstellungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.

plotOrder: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

readonly points: Excel.ChartPointsCollection;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.1

Beispiele

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

// The following code adds data labels to the chart and positions them to demonstrate leader lines.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem(sheetName);
  const chart = sheet.charts.getItemAt(0);
  const series = chart.series.getItemAt(0);
  
  // Enable data labels for the series. Leader lines are enabled by default.
  series.hasDataLabels = true;
  series.points.load("items");
  await context.sync();
  
  // Load the top position for each data label.
  series.points.items.forEach((point) => point.dataLabel.load("top"));
  await context.sync();

  // Move some data labels to create distance from their chart points.
  const point1 = series.points.items[1]; 
  const point2 = series.points.items[2]; 
  point1.dataLabel.top -= 50; 
  point2.dataLabel.top += 50;
  
  // Format the data labels.
  series.dataLabels.geometricShapeType = Excel.GeometricShapeType.rectangle;
  series.dataLabels.showCategoryName = true;
  series.dataLabels.format.border.weight = 1;
  
  await context.sync();
});

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 Kreisdiagramms an. Dies kann ein Wert von 5 bis 200 sein.

secondPlotSize: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.

showConnectorLines: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Gibt an, ob Führungslinien für jede Datenbeschriftung in der Datenreihe angezeigt werden.

showLeaderLines: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Beispiele

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

// The following code disables leader lines for chart data labels.
await Excel.run(async (context) => {
  const sheet = context.workbook.worksheets.getItem(sheetName);
  const chart = sheet.charts.getItemAt(0);
  const series = chart.series.getItemAt(0);
  const dataLabels = series.dataLabels;
  
  // Disable leader lines.
  dataLabels.showLeaderLines = false;
  
  await context.sync();
});

Gibt an, ob die Datenreihe einen Schatten aufweist.

showShadow: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

smooth: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

Hinweise

API-Satz: ExcelApi 1.8

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

splitValue: number;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Die Sammlung von Trendlinien in der Reihe.

readonly trendlines: Excel.ChartTrendlineCollection;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.7

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

varyByCategories: boolean;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.8

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

readonly xErrorBars: Excel.ChartErrorBars;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

readonly yErrorBars: Excel.ChartErrorBars;

Eigenschaftswert

Hinweise

API-Satz: ExcelApi 1.9

Löscht die Diagrammreihen.

delete(): void;

Gibt zurück

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();
});

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

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

Parameter

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);
});

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

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

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.15

Ruft den Datenquellentyp der Diagrammreihe ab.

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

Parameter

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);
});

Ruft den Datenquellentyp der Diagrammreihe ab.

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

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.15

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dabei kann es sich um Kategoriewerte oder Datenwerte handeln, abhängig von der angegebenen Dimension und der Zuordnung der Daten zur Diagrammreihe.

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

Parameter

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}`);
});

Ruft die Werte aus einer einzelnen Dimension der Diagrammreihe ab. Dabei kann es sich um Kategoriewerte oder Datenwerte handeln, abhängig von der angegebenen Dimension und der Zuordnung der Daten zur Diagrammreihe.

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

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.12

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

Gibt zurück

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

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

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

Gibt zurück

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

Gibt zurück

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

set(properties: Excel.ChartSeries): void;

Parameter

Gibt zurück

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

setBubbleSizes(sourceData: Range): void;

Parameter

Gibt zurück

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();
});

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

setValues(sourceData: Range): void;

Parameter

Gibt zurück

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();
});

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

setXAxisValues(sourceData: Range): void;

Parameter

Gibt zurück

Hinweise

API-Satz: ExcelApi 1.7

Ü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 sie übergeben wird.) Während das ursprüngliche Excel.ChartSeries Objekt ein API-Objekt ist, gibt die toJSON Methode ein einfaches JavaScript-Objekt (als Excel.Interfaces.ChartSeriesData) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften des ursprünglichen Objekts enthält.

toJSON(): Excel.Interfaces.ChartSeriesData;

Gibt zurück