ExcelScript.ChartSeries interface

Paket:

ExcelScript

Stellt eine Datenreihe in einem Diagramm dar.

Hinweise

Beispiele

/**
 * This sample produces a line chart with two series.
 * The chart assumes data in A1:E5 that looks like this:
 * Product Qtr1 Qtr2 Qtr3 Qtr4
 * Frames 5000 7000 6544 4377
 * Saddles 400 323 276 651
 */
function main(workbook: ExcelScript.Workbook) {
  // Establish the ranges to use.
  const sheet = workbook.getActiveWorksheet();
  const headerRange = sheet.getRange("A1:E1");
  const firstSeriesRange = sheet.getRange("A2:E2");
  const secondSeriesRange = sheet.getRange("A3:E3");

  // Create the chart.
  const lineChart = sheet.addChart(ExcelScript.ChartType.line, headerRange);

  // Add the first chart series.
  const firstSeries = lineChart.addChartSeries();
  firstSeries.setXAxisValues(headerRange);
  firstSeries.setValues(firstSeriesRange);

  // Add the second chart series.
  const secondSeries = lineChart.addChartSeries();
  secondSeries.setXAxisValues(headerRange);
  secondSeries.setValues(secondSeriesRange);
}

Methoden

addChartTrendline(type)	Fügt der Trendliniensammlung eine neue Trendlinie hinzu.
delete()	Löscht die Diagrammreihen.
getAxisGroup()	Gibt die Gruppe für die angegebene Reihe an.
getBinOptions()	Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme.
getBoxwhiskerOptions()	Verkapselt die Optionen für Kastengrafikdiagramme.
getBubbleScale()	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.
getChartTrendline(index)	Ruft ein Trendlinienobjekt nach Index ab, bei dem es sich um die Einfügereihenfolge im Elementarray handelt.
getChartType()	Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter ExcelScript.ChartType .
getDataLabels()	Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.
getDimensionDataSourceString(dimension)	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.
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.
getDoughnutHoleSize()	Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen InvalidArgument Fehler bei ungültigen Diagrammen aus.
getExplosion()	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).
getFiltered()	Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme.
getFirstSliceAngle()	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.
getFormat()	Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung.
getGapWidth()	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.
getGradientMaximumColor()	Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an.
getGradientMaximumType()	Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an.
getGradientMaximumValue()	Gibt den Maximalwert einer Regionsdiagrammreihe an.
getGradientMidpointColor()	Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an.
getGradientMidpointType()	Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an.
getGradientMidpointValue()	Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.
getGradientMinimumColor()	Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an.
getGradientMinimumType()	Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an.
getGradientMinimumValue()	Gibt den Mindestwert einer Regionsdiagrammreihe an.
getGradientStyle()	Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.
getHasDataLabels()	Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt.
getInvertColor()	Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an.
getInvertIfNegative()	True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht.
getMapOptions()	Verkapselt die Optionen für ein Bereichsdiagramm.
getMarkerBackgroundColor()	Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.
getMarkerForegroundColor()	Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.
getMarkerSize()	Gibt die Markergröße einer Diagrammreihe an.
getMarkerStyle()	Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter ExcelScript.ChartMarkerStyle .
getName()	Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein.
getOverlap()	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.
getParentLabelStrategy()	Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an.
getPlotOrder()	Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.
getPoints()	Gibt eine Auflistung aller Punkte in der Reihe zurück.
getSecondPlotSize()	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.
getShowConnectorLines()	Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.
getShowLeaderLines()	Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden.
getShowShadow()	Gibt an, ob die Reihe einen Schatten aufweist.
getSmooth()	Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme.
getSplitType()	Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden.
getSplitValue()	Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt.
getTrendlines()	Die Auflistung der Trendlinien in der Reihe.
getVaryByCategories()	True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten.
getXErrorBars()	Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.
getYErrorBars()	Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.
setAxisGroup(axisGroup)	Gibt die Gruppe für die angegebene Reihe an.
setBubbleScale(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.
setBubbleSizes(sourceData)	Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme.
setChartType(chartType)	Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter ExcelScript.ChartType .
setDoughnutHoleSize(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.
setExplosion(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).
setFiltered(filtered)	Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme.
setFirstSliceAngle(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.
setGapWidth(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.
setGradientMaximumColor(gradientMaximumColor)	Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an.
setGradientMaximumType(gradientMaximumType)	Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an.
setGradientMaximumValue(gradientMaximumValue)	Gibt den Maximalwert einer Regionsdiagrammreihe an.
setGradientMidpointColor(gradientMidpointColor)	Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an.
setGradientMidpointType(gradientMidpointType)	Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an.
setGradientMidpointValue(gradientMidpointValue)	Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.
setGradientMinimumColor(gradientMinimumColor)	Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an.
setGradientMinimumType(gradientMinimumType)	Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an.
setGradientMinimumValue(gradientMinimumValue)	Gibt den Mindestwert einer Regionsdiagrammreihe an.
setGradientStyle(gradientStyle)	Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.
setHasDataLabels(hasDataLabels)	Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt.
setInvertColor(invertColor)	Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an.
setInvertIfNegative(invertIfNegative)	True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht.
setMarkerBackgroundColor(markerBackgroundColor)	Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.
setMarkerForegroundColor(markerForegroundColor)	Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.
setMarkerSize(markerSize)	Gibt die Markergröße einer Diagrammreihe an.
setMarkerStyle(markerStyle)	Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter ExcelScript.ChartMarkerStyle .
setName(name)	Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein.
setOverlap(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.
setParentLabelStrategy(parentLabelStrategy)	Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an.
setPlotOrder(plotOrder)	Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.
setSecondPlotSize(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.
setShowConnectorLines(showConnectorLines)	Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.
setShowLeaderLines(showLeaderLines)	Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden.
setShowShadow(showShadow)	Gibt an, ob die Reihe einen Schatten aufweist.
setSmooth(smooth)	Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme.
setSplitType(splitType)	Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden.
setSplitValue(splitValue)	Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt.
setValues(sourceData)	Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse.
setVaryByCategories(varyByCategories)	True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten.
setXAxisValues(sourceData)	Legt die Werte der X-Achse für eine Diagrammreihe fest.

Details zur Methode

addChartTrendline(type)

Fügt der Trendliniensammlung eine neue Trendlinie hinzu.

addChartTrendline(type?: ChartTrendlineType): ChartTrendline;

Parameter

type

ExcelScript.ChartTrendlineType

Gibt den Trendlinientyp an. Der Standardwert ist "Linear". Weitere Informationen finden Sie unter ExcelScript.ChartTrendline .

Gibt zurück

ExcelScript.ChartTrendline

delete()

Löscht die Diagrammreihen.

delete(): void;

Gibt zurück

void

getAxisGroup()

Gibt die Gruppe für die angegebene Reihe an.

getAxisGroup(): ChartAxisGroup;

Gibt zurück

ExcelScript.ChartAxisGroup

getBinOptions()

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

getBinOptions(): ChartBinOptions;

Gibt zurück

ExcelScript.ChartBinOptions

getBoxwhiskerOptions()

Verkapselt die Optionen für Kastengrafikdiagramme.

getBoxwhiskerOptions(): ChartBoxwhiskerOptions;

Gibt zurück

ExcelScript.ChartBoxwhiskerOptions

getBubbleScale()

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.

getBubbleScale(): number;

Gibt zurück

number

getChartTrendline(index)

Ruft ein Trendlinienobjekt nach Index ab, bei dem es sich um die Einfügereihenfolge im Elementarray handelt.

getChartTrendline(index: number): ChartTrendline;

Parameter

index

number

Stellt die Einfügereihenfolge im Elementarray dar.

Gibt zurück

ExcelScript.ChartTrendline

getChartType()

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

getChartType(): ChartType;

Gibt zurück

ExcelScript.ChartType

getDataLabels()

Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.

getDataLabels(): ChartDataLabels;

Gibt zurück

ExcelScript.ChartDataLabels

getDimensionDataSourceString(dimension)

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

getDimensionDataSourceString(dimension: ChartSeriesDimension): string;

Parameter

dimension

ExcelScript.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

string

getDimensionDataSourceType(dimension)

Ruft den Datenquellentyp der Diagrammreihe ab.

getDimensionDataSourceType(
            dimension: ChartSeriesDimension
        ): ChartDataSourceType;

Parameter

dimension

ExcelScript.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

ExcelScript.ChartDataSourceType

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: ChartSeriesDimension): string[];

Parameter

dimension

ExcelScript.ChartSeriesDimension

Die Dimension der Achse, von der die Daten stammen.

Gibt zurück

string[]

getDoughnutHoleSize()

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

getDoughnutHoleSize(): number;

Gibt zurück

number

getExplosion()

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

getExplosion(): number;

Gibt zurück

number

getFiltered()

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

getFiltered(): boolean;

Gibt zurück

boolean

getFirstSliceAngle()

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.

getFirstSliceAngle(): number;

Gibt zurück

number

getFormat()

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

getFormat(): ChartSeriesFormat;

Gibt zurück

ExcelScript.ChartSeriesFormat

getGapWidth()

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.

getGapWidth(): number;

Gibt zurück

number

getGradientMaximumColor()

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

getGradientMaximumColor(): string;

Gibt zurück

string

getGradientMaximumType()

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

getGradientMaximumType(): ChartGradientStyleType;

Gibt zurück

ExcelScript.ChartGradientStyleType

getGradientMaximumValue()

Gibt den Maximalwert einer Regionsdiagrammreihe an.

getGradientMaximumValue(): number;

Gibt zurück

number

getGradientMidpointColor()

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

getGradientMidpointColor(): string;

Gibt zurück

string

getGradientMidpointType()

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

getGradientMidpointType(): ChartGradientStyleType;

Gibt zurück

ExcelScript.ChartGradientStyleType

getGradientMidpointValue()

Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.

getGradientMidpointValue(): number;

Gibt zurück

number

getGradientMinimumColor()

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

getGradientMinimumColor(): string;

Gibt zurück

string

getGradientMinimumType()

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

getGradientMinimumType(): ChartGradientStyleType;

Gibt zurück

ExcelScript.ChartGradientStyleType

getGradientMinimumValue()

Gibt den Mindestwert einer Regionsdiagrammreihe an.

getGradientMinimumValue(): number;

Gibt zurück

number

getGradientStyle()

Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.

getGradientStyle(): ChartGradientStyle;

Gibt zurück

ExcelScript.ChartGradientStyle

getHasDataLabels()

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

getHasDataLabels(): boolean;

Gibt zurück

boolean

getInvertColor()

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

getInvertColor(): string;

Gibt zurück

string

getInvertIfNegative()

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

getInvertIfNegative(): boolean;

Gibt zurück

boolean

getMapOptions()

Verkapselt die Optionen für ein Bereichsdiagramm.

getMapOptions(): ChartMapOptions;

Gibt zurück

ExcelScript.ChartMapOptions

getMarkerBackgroundColor()

Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.

getMarkerBackgroundColor(): string;

Gibt zurück

string

getMarkerForegroundColor()

Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.

getMarkerForegroundColor(): string;

Gibt zurück

string

getMarkerSize()

Gibt die Markergröße einer Diagrammreihe an.

getMarkerSize(): number;

Gibt zurück

number

getMarkerStyle()

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

getMarkerStyle(): ChartMarkerStyle;

Gibt zurück

ExcelScript.ChartMarkerStyle

getName()

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

getName(): string;

Gibt zurück

string

Beispiele

/**
 * This sample logs the names of each of the chart series in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Log the name of each chart series in the chart.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    console.log(series.getName());
  });
}

getOverlap()

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.

getOverlap(): number;

Gibt zurück

number

getParentLabelStrategy()

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

getParentLabelStrategy(): ChartParentLabelStrategy;

Gibt zurück

ExcelScript.ChartParentLabelStrategy

getPlotOrder()

Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.

getPlotOrder(): number;

Gibt zurück

number

getPoints()

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

getPoints(): ChartPoint[];

Gibt zurück

ExcelScript.ChartPoint[]

getSecondPlotSize()

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.

getSecondPlotSize(): number;

Gibt zurück

number

getShowConnectorLines()

Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.

getShowConnectorLines(): boolean;

Gibt zurück

boolean

getShowLeaderLines()

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

getShowLeaderLines(): boolean;

Gibt zurück

boolean

getShowShadow()

Gibt an, ob die Reihe einen Schatten aufweist.

getShowShadow(): boolean;

Gibt zurück

boolean

getSmooth()

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

getSmooth(): boolean;

Gibt zurück

boolean

getSplitType()

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

getSplitType(): ChartSplitType;

Gibt zurück

ExcelScript.ChartSplitType

getSplitValue()

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

getSplitValue(): number;

Gibt zurück

number

getTrendlines()

Die Auflistung der Trendlinien in der Reihe.

getTrendlines(): ChartTrendline[];

Gibt zurück

ExcelScript.ChartTrendline[]

getVaryByCategories()

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

getVaryByCategories(): boolean;

Gibt zurück

boolean

getXErrorBars()

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

getXErrorBars(): ChartErrorBars;

Gibt zurück

ExcelScript.ChartErrorBars

getYErrorBars()

Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.

getYErrorBars(): ChartErrorBars;

Gibt zurück

ExcelScript.ChartErrorBars

Beispiele

/**
 * This script adds error bars for the standard error of each chart series point.
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the range for the chart.
  const worksheet = workbook.getWorksheet("Sample");
  const dataRange = worksheet.getRange("A1:B15");

  // Create a line chart.
  const chart = worksheet.addChart(ExcelScript.ChartType.line, dataRange);

  // For each series, add error bars for the standard error on each point
  const allSeries = chart.getSeries();
  allSeries.forEach((series) => {
    series.getYErrorBars().setType(ExcelScript.ChartErrorBarsType.stError);
    series.getYErrorBars().setVisible(true);
  });
}

setAxisGroup(axisGroup)

Gibt die Gruppe für die angegebene Reihe an.

setAxisGroup(axisGroup: ChartAxisGroup): void;

Parameter

axisGroup

ExcelScript.ChartAxisGroup

Gibt zurück

void

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

setBubbleScale(bubbleScale: number): void;

Parameter

bubbleScale

number

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

ExcelScript.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void

setChartType(chartType)

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

setChartType(chartType: ChartType): void;

Parameter

chartType

ExcelScript.ChartType

Gibt zurück

void

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

setDoughnutHoleSize(doughnutHoleSize: number): void;

Parameter

doughnutHoleSize

number

Gibt zurück

void

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

setExplosion(explosion: number): void;

Parameter

explosion

number

Gibt zurück

void

setFiltered(filtered)

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

setFiltered(filtered: boolean): void;

Parameter

filtered

boolean

Gibt zurück

void

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

setFirstSliceAngle(firstSliceAngle: number): void;

Parameter

firstSliceAngle

number

Gibt zurück

void

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

setGapWidth(gapWidth: number): void;

Parameter

gapWidth

number

Gibt zurück

void

setGradientMaximumColor(gradientMaximumColor)

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

setGradientMaximumColor(gradientMaximumColor: string): void;

Parameter

gradientMaximumColor

string

Gibt zurück

void

setGradientMaximumType(gradientMaximumType)

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

setGradientMaximumType(
            gradientMaximumType: ChartGradientStyleType
        ): void;

Parameter

gradientMaximumType

ExcelScript.ChartGradientStyleType

Gibt zurück

void

setGradientMaximumValue(gradientMaximumValue)

Gibt den Maximalwert einer Regionsdiagrammreihe an.

setGradientMaximumValue(gradientMaximumValue: number): void;

Parameter

gradientMaximumValue

number

Gibt zurück

void

setGradientMidpointColor(gradientMidpointColor)

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

setGradientMidpointColor(gradientMidpointColor: string): void;

Parameter

gradientMidpointColor

string

Gibt zurück

void

setGradientMidpointType(gradientMidpointType)

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

setGradientMidpointType(
            gradientMidpointType: ChartGradientStyleType
        ): void;

Parameter

gradientMidpointType

ExcelScript.ChartGradientStyleType

Gibt zurück

void

setGradientMidpointValue(gradientMidpointValue)

Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.

setGradientMidpointValue(gradientMidpointValue: number): void;

Parameter

gradientMidpointValue

number

Gibt zurück

void

setGradientMinimumColor(gradientMinimumColor)

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

setGradientMinimumColor(gradientMinimumColor: string): void;

Parameter

gradientMinimumColor

string

Gibt zurück

void

setGradientMinimumType(gradientMinimumType)

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

setGradientMinimumType(
            gradientMinimumType: ChartGradientStyleType
        ): void;

Parameter

gradientMinimumType

ExcelScript.ChartGradientStyleType

Gibt zurück

void

setGradientMinimumValue(gradientMinimumValue)

Gibt den Mindestwert einer Regionsdiagrammreihe an.

setGradientMinimumValue(gradientMinimumValue: number): void;

Parameter

gradientMinimumValue

number

Gibt zurück

void

setGradientStyle(gradientStyle)

Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.

setGradientStyle(gradientStyle: ChartGradientStyle): void;

Parameter

gradientStyle

ExcelScript.ChartGradientStyle

Gibt zurück

void

setHasDataLabels(hasDataLabels)

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

setHasDataLabels(hasDataLabels: boolean): void;

Parameter

hasDataLabels

boolean

Gibt zurück

void

setInvertColor(invertColor)

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

setInvertColor(invertColor: string): void;

Parameter

invertColor

string

Gibt zurück

void

setInvertIfNegative(invertIfNegative)

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

setInvertIfNegative(invertIfNegative: boolean): void;

Parameter

invertIfNegative

boolean

Gibt zurück

void

setMarkerBackgroundColor(markerBackgroundColor)

Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.

setMarkerBackgroundColor(markerBackgroundColor: string): void;

Parameter

markerBackgroundColor

string

Gibt zurück

void

setMarkerForegroundColor(markerForegroundColor)

Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.

setMarkerForegroundColor(markerForegroundColor: string): void;

Parameter

markerForegroundColor

string

Gibt zurück

void

setMarkerSize(markerSize)

Gibt die Markergröße einer Diagrammreihe an.

setMarkerSize(markerSize: number): void;

Parameter

markerSize

number

Gibt zurück

void

setMarkerStyle(markerStyle)

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

setMarkerStyle(markerStyle: ChartMarkerStyle): void;

Parameter

markerStyle

ExcelScript.ChartMarkerStyle

Gibt zurück

void

setName(name)

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

setName(name: string): void;

Parameter

name

string

Gibt zurück

void

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

setOverlap(overlap: number): void;

Parameter

overlap

number

Gibt zurück

void

Beispiele

/**
 * This sample sets the overlap of the columns in a chart named "ColumnClusteredChart".
 */
function main(workbook: ExcelScript.Workbook) {
  // Get the current worksheet.
  let selectedSheet = workbook.getActiveWorksheet();

  // Get an existing chart named "ColumnClusteredChart".
  let chart = selectedSheet.getChart("ColumnClusteredChart");

  // Set the overlap of every column of each series within a category.
  let seriesList = chart.getSeries();
  seriesList.forEach((series) => {
    // An overlap of 25 means the columns have 25% of their length overlapping with the adjacent columns in the same category.
    series.setOverlap(25);
  });
}

setParentLabelStrategy(parentLabelStrategy)

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

setParentLabelStrategy(
            parentLabelStrategy: ChartParentLabelStrategy
        ): void;

Parameter

parentLabelStrategy

ExcelScript.ChartParentLabelStrategy

Gibt zurück

void

setPlotOrder(plotOrder)

Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.

setPlotOrder(plotOrder: number): void;

Parameter

plotOrder

number

Gibt zurück

void

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

setSecondPlotSize(secondPlotSize: number): void;

Parameter

secondPlotSize

number

Gibt zurück

void

setShowConnectorLines(showConnectorLines)

Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.

setShowConnectorLines(showConnectorLines: boolean): void;

Parameter

showConnectorLines

boolean

Gibt zurück

void

setShowLeaderLines(showLeaderLines)

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

setShowLeaderLines(showLeaderLines: boolean): void;

Parameter

showLeaderLines

boolean

Gibt zurück

void

setShowShadow(showShadow)

Gibt an, ob die Reihe einen Schatten aufweist.

setShowShadow(showShadow: boolean): void;

Parameter

showShadow

boolean

Gibt zurück

void

setSmooth(smooth)

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

setSmooth(smooth: boolean): void;

Parameter

smooth

boolean

Gibt zurück

void

setSplitType(splitType)

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

setSplitType(splitType: ChartSplitType): void;

Parameter

splitType

ExcelScript.ChartSplitType

Gibt zurück

void

setSplitValue(splitValue)

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

setSplitValue(splitValue: number): void;

Parameter

splitValue

number

Gibt zurück

void

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

ExcelScript.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void

setVaryByCategories(varyByCategories)

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

setVaryByCategories(varyByCategories: boolean): void;

Parameter

varyByCategories

boolean

Gibt zurück

void

setXAxisValues(sourceData)

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

setXAxisValues(sourceData: Range): void;

Parameter

sourceData

ExcelScript.Range

Das Range -Objekt, das den Quelldaten entspricht.

Gibt zurück

void