ExcelScript.ChartSeries interface
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
add |
Fügt der Trendliniensammlung eine neue Trendlinie hinzu. |
delete() | Löscht die Diagrammreihen. |
get |
Gibt die Gruppe für die angegebene Reihe an. |
get |
Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme. |
get |
Verkapselt die Optionen für Kastengrafikdiagramme. |
get |
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. |
get |
Ruft ein Trendlinienobjekt nach Index ab, bei dem es sich um die Einfügereihenfolge im Elementarray handelt. |
get |
Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter |
get |
Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar. |
get |
Ruft die Zeichenfolgendarstellung der Datenquelle der Diagrammreihe ab. Bei der Zeichenfolgendarstellung kann es sich um Informationen wie eine Zellenadresse handeln. |
get |
Ruft den Datenquellentyp der Diagrammreihe ab. |
get |
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. |
get |
Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen |
get |
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). |
get |
Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme. |
get |
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. |
get |
Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung. |
get |
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. |
get |
Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an. |
get |
Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an. |
get |
Gibt den Maximalwert einer Regionsdiagrammreihe an. |
get |
Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
get |
Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
get |
Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an. |
get |
Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an. |
get |
Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an. |
get |
Gibt den Mindestwert einer Regionsdiagrammreihe an. |
get |
Gibt den Reihenverlaufsstil eines Bereichsdiagramms an. |
get |
Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt. |
get |
Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an. |
get |
True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht. |
get |
Verkapselt die Optionen für ein Bereichsdiagramm. |
get |
Gibt die Markierungshintergrundfarbe einer Diagrammreihe an. |
get |
Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an. |
get |
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. |
get |
Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter |
get |
Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein. |
get |
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. |
get |
Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an. |
get |
Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an. |
get |
Gibt eine Auflistung aller Punkte in der Reihe zurück. |
get |
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. |
get |
Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden. |
get |
Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden. |
get |
Gibt an, ob die Reihe einen Schatten aufweist. |
get |
Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme. |
get |
Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden. |
get |
Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt. |
get |
Die Auflistung der Trendlinien in der Reihe. |
get |
True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten. |
get |
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar. |
get |
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar. |
set |
Gibt die Gruppe für die angegebene Reihe an. |
set |
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. |
set |
Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme. |
set |
Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter |
set |
Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen |
set |
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). |
set |
Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme. |
set |
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. |
set |
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. |
set |
Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an. |
set |
Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an. |
set |
Gibt den Maximalwert einer Regionsdiagrammreihe an. |
set |
Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
set |
Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
set |
Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an. |
set |
Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an. |
set |
Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an. |
set |
Gibt den Mindestwert einer Regionsdiagrammreihe an. |
set |
Gibt den Reihenverlaufsstil eines Bereichsdiagramms an. |
set |
Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt. |
set |
Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an. |
set |
True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht. |
set |
Gibt die Markierungshintergrundfarbe einer Diagrammreihe an. |
set |
Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an. |
set |
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. |
set |
Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter |
set |
Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein. |
set |
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. |
set |
Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an. |
set |
Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an. |
set |
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. |
set |
Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden. |
set |
Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden. |
set |
Gibt an, ob die Reihe einen Schatten aufweist. |
set |
Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme. |
set |
Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden. |
set |
Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt. |
set |
Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse. |
set |
True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten. |
set |
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
Gibt den Trendlinientyp an. Der Standardwert ist "Linear". Weitere Informationen finden Sie unter ExcelScript.ChartTrendline
.
Gibt zurück
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
getBinOptions()
Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme.
getBinOptions(): ChartBinOptions;
Gibt zurück
getBoxwhiskerOptions()
Verkapselt die Optionen für Kastengrafikdiagramme.
getBoxwhiskerOptions(): ChartBoxwhiskerOptions;
Gibt zurück
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
getChartType()
Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter ExcelScript.ChartType
.
getChartType(): ChartType;
Gibt zurück
getDataLabels()
Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.
getDataLabels(): ChartDataLabels;
Gibt zurück
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
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
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
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
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
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
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
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. 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.
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
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
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
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
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
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
getYErrorBars()
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.
getYErrorBars(): ChartErrorBars;
Gibt zurück
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. 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.
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
Office Scripts