Excel.ChartSeries class
Stellt eine Datenreihe in einem Diagramm dar.
- Extends
Hinweise
Eigenschaften
axis |
Gibt die Gruppe für die angegebene Reihe an. |
bin |
Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme. |
boxwhisker |
Verkapselt die Optionen für Kastengrafikdiagramme. |
bubble |
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. |
chart |
Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter |
context | Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden. |
data |
Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar. |
doughnut |
Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen |
explosion | Gibt den Explosionswert für ein Kreisdiagramm- oder Ringdiagrammsegment an. Gibt 0 (null) zurück, wenn keine Explosion vorliegt (die Spitze des Segments befindet sich in der Mitte des Kreisdiagramms). |
filtered | Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme. |
first |
Gibt den Winkel des ersten Kreisdiagramm- oder Ringdiagrammsegments in Grad an (im Uhrzeigersinn ab vertikal). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme. Dies kann ein Wert von 0 bis 360 sein. |
format | Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung. |
gap |
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. |
gradient |
Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an. |
gradient |
Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an. |
gradient |
Gibt den Maximalwert einer Regionsdiagrammreihe an. |
gradient |
Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
gradient |
Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an. |
gradient |
Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an. |
gradient |
Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an. |
gradient |
Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an. |
gradient |
Gibt den Mindestwert einer Regionsdiagrammreihe an. |
gradient |
Gibt den Reihenverlaufsstil eines Bereichsdiagramms an. |
has |
Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt. |
invert |
Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an. |
invert |
True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht. |
map |
Verkapselt die Optionen für ein Bereichsdiagramm. |
marker |
Gibt die Markierungshintergrundfarbe einer Diagrammreihe an. |
marker |
Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an. |
marker |
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. |
marker |
Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter |
name | Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein. |
overlap | Gibt an, wie Balken und Spalten angeordnet sind. Dies kann ein Wert zwischen –100 und 100 sein. Gilt nur für 2D-Balken- und 2D-Säulendiagramme. |
parent |
Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an. |
plot |
Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an. |
points | Gibt eine Auflistung aller Punkte in der Reihe zurück. |
second |
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. |
show |
Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden. |
show |
Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden. |
show |
Gibt an, ob die Reihe einen Schatten aufweist. |
smooth | Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme. |
split |
Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden. |
split |
Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt. |
trendlines | Die Auflistung der Trendlinien in der Reihe. |
vary |
True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten. |
x |
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar. |
y |
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar. |
Methoden
delete() | Löscht die Diagrammreihen. |
load(options) | Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
load(property |
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie " |
set(properties, options) | Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben. |
set(properties) | Legt mehrere Eigenschaften für das -Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt. |
set |
Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme. |
set |
Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse. |
set |
Legt die Werte der X-Achse für eine Diagrammreihe fest. |
toJSON() | Überschreibt die JavaScript-Methode |
Details zur Eigenschaft
axisGroup
Gibt die Gruppe für die angegebene Reihe an.
axisGroup: Excel.ChartAxisGroup | "Primary" | "Secondary";
Eigenschaftswert
Excel.ChartAxisGroup | "Primary" | "Secondary"
Hinweise
binOptions
Verkapselt die Intervalloptionen für Histogramme und Pareto-Diagramme.
readonly binOptions: Excel.ChartBinOptions;
Eigenschaftswert
Hinweise
boxwhiskerOptions
Verkapselt die Optionen für Kastengrafikdiagramme.
readonly boxwhiskerOptions: Excel.ChartBoxwhiskerOptions;
Eigenschaftswert
Hinweise
bubbleScale
Dies kann ein ganzzahliger Wert von 0 (null) bis 300 sein, der einem Prozentsatz der Standardgröße darstellt. Diese Eigenschaft gilt nur für Blasendiagramme.
bubbleScale: number;
Eigenschaftswert
number
Hinweise
chartType
Stellt den Diagrammtyp einer Reihe dar. Weitere Informationen finden Sie unter Excel.ChartType
.
chartType: Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel";
Eigenschaftswert
Excel.ChartType | "Invalid" | "ColumnClustered" | "ColumnStacked" | "ColumnStacked100" | "3DColumnClustered" | "3DColumnStacked" | "3DColumnStacked100" | "BarClustered" | "BarStacked" | "BarStacked100" | "3DBarClustered" | "3DBarStacked" | "3DBarStacked100" | "LineStacked" | "LineStacked100" | "LineMarkers" | "LineMarkersStacked" | "LineMarkersStacked100" | "PieOfPie" | "PieExploded" | "3DPieExploded" | "BarOfPie" | "XYScatterSmooth" | "XYScatterSmoothNoMarkers" | "XYScatterLines" | "XYScatterLinesNoMarkers" | "AreaStacked" | "AreaStacked100" | "3DAreaStacked" | "3DAreaStacked100" | "DoughnutExploded" | "RadarMarkers" | "RadarFilled" | "Surface" | "SurfaceWireframe" | "SurfaceTopView" | "SurfaceTopViewWireframe" | "Bubble" | "Bubble3DEffect" | "StockHLC" | "StockOHLC" | "StockVHLC" | "StockVOHLC" | "CylinderColClustered" | "CylinderColStacked" | "CylinderColStacked100" | "CylinderBarClustered" | "CylinderBarStacked" | "CylinderBarStacked100" | "CylinderCol" | "ConeColClustered" | "ConeColStacked" | "ConeColStacked100" | "ConeBarClustered" | "ConeBarStacked" | "ConeBarStacked100" | "ConeCol" | "PyramidColClustered" | "PyramidColStacked" | "PyramidColStacked100" | "PyramidBarClustered" | "PyramidBarStacked" | "PyramidBarStacked100" | "PyramidCol" | "3DColumn" | "Line" | "3DLine" | "3DPie" | "Pie" | "XYScatter" | "3DArea" | "Area" | "Doughnut" | "Radar" | "Histogram" | "Boxwhisker" | "Pareto" | "RegionMap" | "Treemap" | "Waterfall" | "Sunburst" | "Funnel"
Hinweise
context
Der Anforderungskontext, der dem -Objekt zugeordnet ist. Dadurch wird der Prozess des Add-Ins mit dem Prozess der Office-Hostanwendung verbunden.
context: RequestContext;
Eigenschaftswert
dataLabels
Stellt eine Auflistung aller Datenbeschriftungen in der Reihe dar.
readonly dataLabels: Excel.ChartDataLabels;
Eigenschaftswert
Hinweise
doughnutHoleSize
Stellt die Innenringgröße einer Diagrammreihe dar. Nur in Ring- und Ringdiagrammen gültig. Löst einen InvalidArgument
Fehler bei ungültigen Diagrammen aus.
doughnutHoleSize: number;
Eigenschaftswert
number
Hinweise
explosion
Gibt den Explosionswert für ein Kreisdiagramm- oder Ringdiagrammsegment an. Gibt 0 (null) zurück, wenn keine Explosion vorliegt (die Spitze des Segments befindet sich in der Mitte des Kreisdiagramms).
explosion: number;
Eigenschaftswert
number
Hinweise
filtered
Gibt an, ob die Reihe gefiltert wird. Gilt nicht für Oberflächendiagramme.
filtered: boolean;
Eigenschaftswert
boolean
Hinweise
firstSliceAngle
Gibt den Winkel des ersten Kreisdiagramm- oder Ringdiagrammsegments in Grad an (im Uhrzeigersinn ab vertikal). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme. Dies kann ein Wert von 0 bis 360 sein.
firstSliceAngle: number;
Eigenschaftswert
number
Hinweise
format
Stellt die Formatierung für eine Diagrammdatenreihe dar, einschließlich Füllung und Linienformatierung.
readonly format: Excel.ChartSeriesFormat;
Eigenschaftswert
Hinweise
gapWidth
Stellt die Abstandsbreite einer Diagrammreihe dar. Nur gültig für Balken- und Säulendiagramme sowie bestimmte Klassen von Linien- und Kreisdiagrammen. Löst eine Ausnahme für ungültige Argumente für ungültige Diagramme aus.
gapWidth: number;
Eigenschaftswert
number
Hinweise
gradientMaximumColor
Gibt die Farbe für den Maximalwert einer Regionsdiagrammreihe an.
gradientMaximumColor: string;
Eigenschaftswert
string
Hinweise
gradientMaximumType
Gibt den Typ für den Maximalwert einer Regionsdiagrammreihe an.
gradientMaximumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";
Eigenschaftswert
Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"
Hinweise
gradientMaximumValue
Gibt den Maximalwert einer Regionsdiagrammreihe an.
gradientMaximumValue: number;
Eigenschaftswert
number
Hinweise
gradientMidpointColor
Gibt die Farbe für den Mittelpunktwert einer Bereichsdiagrammreihe an.
gradientMidpointColor: string;
Eigenschaftswert
string
Hinweise
gradientMidpointType
Gibt den Typ für den Mittelpunktwert einer Bereichsdiagrammreihe an.
gradientMidpointType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";
Eigenschaftswert
Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"
Hinweise
gradientMidpointValue
Gibt den Mittelpunktwert einer Datenreihe mit Regionszuordnungsdiagrammen an.
gradientMidpointValue: number;
Eigenschaftswert
number
Hinweise
gradientMinimumColor
Gibt die Farbe für den Minimalwert einer Regionsdiagrammreihe an.
gradientMinimumColor: string;
Eigenschaftswert
string
Hinweise
gradientMinimumType
Gibt den Typ für den Mindestwert einer Regionsdiagrammreihe an.
gradientMinimumType: Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent";
Eigenschaftswert
Excel.ChartGradientStyleType | "ExtremeValue" | "Number" | "Percent"
Hinweise
gradientMinimumValue
Gibt den Mindestwert einer Regionsdiagrammreihe an.
gradientMinimumValue: number;
Eigenschaftswert
number
Hinweise
gradientStyle
Gibt den Reihenverlaufsstil eines Bereichsdiagramms an.
gradientStyle: Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor";
Eigenschaftswert
Excel.ChartGradientStyle | "TwoPhaseColor" | "ThreePhaseColor"
Hinweise
hasDataLabels
Gibt an, ob die Datenreihe über Datenbeschriftungen verfügt.
hasDataLabels: boolean;
Eigenschaftswert
boolean
Hinweise
invertColor
Gibt die Füllfarbe für negative Datenpunkte in einer Reihe an.
invertColor: string;
Eigenschaftswert
string
Hinweise
invertIfNegative
True, wenn Excel das Muster im Element umkehrt, wenn es einer negativen Zahl entspricht.
invertIfNegative: boolean;
Eigenschaftswert
boolean
Hinweise
mapOptions
Verkapselt die Optionen für ein Bereichsdiagramm.
readonly mapOptions: Excel.ChartMapOptions;
Eigenschaftswert
Hinweise
markerBackgroundColor
Gibt die Markierungshintergrundfarbe einer Diagrammreihe an.
markerBackgroundColor: string;
Eigenschaftswert
string
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
await Excel.run(async (context) => {
let sheet = context.workbook.worksheets.getItem("Sample");
let salesTable = sheet.tables.getItem("SalesTable");
let dataRange = sheet.getRange("A1:E7");
// Create an XY scatter chart.
let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
chart.title.text = "Bicycle Parts Quarterly Sales";
let series = chart.series;
let series0 = series.getItemAt(0);
let series1 = series.getItemAt(1);
let series2 = series.getItemAt(2);
let series3 = series.getItemAt(3);
// Set markers.
series0.markerStyle = "Dash";
series0.markerForegroundColor = "black";
series1.markerStyle = "Star";
series1.markerForegroundColor = "black";
series2.markerStyle = "X";
series2.markerSize = 12;
series3.markerStyle = "Triangle";
series3.markerBackgroundColor = "purple";
await context.sync();
});
markerForegroundColor
Gibt die Vordergrundfarbe der Markierung einer Diagrammreihe an.
markerForegroundColor: string;
Eigenschaftswert
string
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
await Excel.run(async (context) => {
let sheet = context.workbook.worksheets.getItem("Sample");
let salesTable = sheet.tables.getItem("SalesTable");
let dataRange = sheet.getRange("A1:E7");
// Create an XY scatter chart.
let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
chart.title.text = "Bicycle Parts Quarterly Sales";
let series = chart.series;
let series0 = series.getItemAt(0);
let series1 = series.getItemAt(1);
let series2 = series.getItemAt(2);
let series3 = series.getItemAt(3);
// Set markers.
series0.markerStyle = "Dash";
series0.markerForegroundColor = "black";
series1.markerStyle = "Star";
series1.markerForegroundColor = "black";
series2.markerStyle = "X";
series2.markerSize = 12;
series3.markerStyle = "Triangle";
series3.markerBackgroundColor = "purple";
await context.sync();
});
markerSize
Gibt die Markergröße einer Diagrammreihe an. Der unterstützte Größenbereich beträgt 2 bis 72. Diese Methode gibt einen InvalidArgument-Fehler zurück, wenn sie mit einer Größe außerhalb des unterstützten Bereichs festgelegt ist.
markerSize: number;
Eigenschaftswert
number
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
await Excel.run(async (context) => {
let sheet = context.workbook.worksheets.getItem("Sample");
let salesTable = sheet.tables.getItem("SalesTable");
let dataRange = sheet.getRange("A1:E7");
// Create an XY scatter chart.
let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
chart.title.text = "Bicycle Parts Quarterly Sales";
let series = chart.series;
let series0 = series.getItemAt(0);
let series1 = series.getItemAt(1);
let series2 = series.getItemAt(2);
let series3 = series.getItemAt(3);
// Set markers.
series0.markerStyle = "Dash";
series0.markerForegroundColor = "black";
series1.markerStyle = "Star";
series1.markerForegroundColor = "black";
series2.markerStyle = "X";
series2.markerSize = 12;
series3.markerStyle = "Triangle";
series3.markerBackgroundColor = "purple";
await context.sync();
});
markerStyle
Gibt das Markerformat einer Diagrammreihe an. Weitere Informationen finden Sie unter Excel.ChartMarkerStyle
.
markerStyle: Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture";
Eigenschaftswert
Excel.ChartMarkerStyle | "Invalid" | "Automatic" | "None" | "Square" | "Diamond" | "Triangle" | "X" | "Star" | "Dot" | "Dash" | "Circle" | "Plus" | "Picture"
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series-markers.yaml
await Excel.run(async (context) => {
let sheet = context.workbook.worksheets.getItem("Sample");
let salesTable = sheet.tables.getItem("SalesTable");
let dataRange = sheet.getRange("A1:E7");
// Create an XY scatter chart.
let chart = sheet.charts.add("XYScatterSmooth", dataRange, "Auto");
chart.title.text = "Bicycle Parts Quarterly Sales";
let series = chart.series;
let series0 = series.getItemAt(0);
let series1 = series.getItemAt(1);
let series2 = series.getItemAt(2);
let series3 = series.getItemAt(3);
// Set markers.
series0.markerStyle = "Dash";
series0.markerForegroundColor = "black";
series1.markerStyle = "Star";
series1.markerForegroundColor = "black";
series2.markerStyle = "X";
series2.markerSize = 12;
series3.markerStyle = "Triangle";
series3.markerBackgroundColor = "purple";
await context.sync();
});
name
Gibt den Namen einer Datenreihe in einem Diagramm an. Die Länge des Namens darf nicht größer als 255 Zeichen sein.
name: string;
Eigenschaftswert
string
Hinweise
overlap
Gibt an, wie Balken und Spalten angeordnet sind. Dies kann ein Wert zwischen –100 und 100 sein. Gilt nur für 2D-Balken- und 2D-Säulendiagramme.
overlap: number;
Eigenschaftswert
number
Hinweise
parentLabelStrategy
Gibt den Strategiebereich für übergeordnete Bezeichnungen der Reihe für ein Treemap-Diagramm an.
parentLabelStrategy: Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping";
Eigenschaftswert
Excel.ChartParentLabelStrategy | "None" | "Banner" | "Overlapping"
Hinweise
plotOrder
Gibt die Zeichnungsreihenfolge einer Diagrammreihe innerhalb der Diagrammgruppe an.
plotOrder: number;
Eigenschaftswert
number
Hinweise
points
Gibt eine Auflistung aller Punkte in der Reihe zurück.
readonly points: Excel.ChartPointsCollection;
Eigenschaftswert
Hinweise
secondPlotSize
Gibt die Größe des sekundären Abschnitts eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms als Prozentsatz der Größe des primären Kreises an. Dies kann ein Wert von 5 bis 200 sein.
secondPlotSize: number;
Eigenschaftswert
number
Hinweise
showConnectorLines
Gibt an, ob Verbindungslinien in Wasserfalldiagrammen angezeigt werden.
showConnectorLines: boolean;
Eigenschaftswert
boolean
Hinweise
showLeaderLines
Gibt an, ob Führungslinien für jede Datenbezeichnung in der Reihe angezeigt werden.
showLeaderLines: boolean;
Eigenschaftswert
boolean
Hinweise
showShadow
Gibt an, ob die Reihe einen Schatten aufweist.
showShadow: boolean;
Eigenschaftswert
boolean
Hinweise
smooth
Gibt an, ob die Reihe glatt ist. Gilt nur für Linien- und Punktdiagramme.
smooth: boolean;
Eigenschaftswert
boolean
Hinweise
splitType
Gibt an, wie die beiden Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms aufgeteilt werden.
splitType: Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit";
Eigenschaftswert
Excel.ChartSplitType | "SplitByPosition" | "SplitByValue" | "SplitByPercentValue" | "SplitByCustomSplit"
Hinweise
splitValue
Gibt den Schwellenwert an, der zwei Abschnitte eines Kreis-aus-Kreis-Diagramms oder eines Balken-aus-Kreis-Diagramms trennt.
splitValue: number;
Eigenschaftswert
number
Hinweise
trendlines
Die Auflistung der Trendlinien in der Reihe.
readonly trendlines: Excel.ChartTrendlineCollection;
Eigenschaftswert
Hinweise
varyByCategories
True, wenn Excel jedem Datenmarker eine andere Farbe oder ein anderes Muster zuweist. Das Diagramm darf nur eine Datenreihe enthalten.
varyByCategories: boolean;
Eigenschaftswert
boolean
Hinweise
xErrorBars
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.
readonly xErrorBars: Excel.ChartErrorBars;
Eigenschaftswert
Hinweise
yErrorBars
Stellt das Fehlerbalkenobjekt für eine Datenreihe dar.
readonly yErrorBars: Excel.ChartErrorBars;
Eigenschaftswert
Hinweise
Details zur Methode
delete()
Löscht die Diagrammreihen.
delete(): void;
Gibt zurück
void
Hinweise
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();
});
load(options)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()
" aufrufen.
load(options?: Excel.Interfaces.ChartSeriesLoadOptions): Excel.ChartSeries;
Parameter
Stellt Optionen dafür bereit, welche Eigenschaften des -Objekts geladen werden sollen.
Gibt zurück
load(propertyNames)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()
" aufrufen.
load(propertyNames?: string | string[]): Excel.ChartSeries;
Parameter
- propertyNames
-
string | string[]
Eine durch Trennzeichen getrennte Zeichenfolge oder ein Array von Zeichenfolgen, die die zu ladenden Eigenschaften angeben.
Gibt zurück
Beispiele
// Rename the 1st series of Chart1 to "New Series Name".
await Excel.run(async (context) => {
const chart = context.workbook.worksheets.getItem("Sheet1").charts.getItem("Chart1");
chart.series.getItemAt(0).name = "New Series Name";
await context.sync();
console.log("Series1 Renamed");
});
load(propertyNamesAndPaths)
Stellt einen Befehl zum Laden der angegebenen Eigenschaften des Objekts in die Warteschlange ein. Vor dem Lesen der Eigenschaften müssen Sie "context.sync()
" aufrufen.
load(propertyNamesAndPaths?: {
select?: string;
expand?: string;
}): Excel.ChartSeries;
Parameter
- propertyNamesAndPaths
-
{ select?: string; expand?: string; }
propertyNamesAndPaths.select
ist eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Eigenschaften angibt, und propertyNamesAndPaths.expand
eine durch Trennzeichen getrennte Zeichenfolge, die die zu ladenden Navigationseigenschaften angibt.
Gibt zurück
set(properties, options)
Legt mehrere Eigenschaften eines Objekts gleichzeitig fest. Sie können entweder ein einfaches Objekt mit den entsprechenden Eigenschaften oder ein anderes API-Objekt desselben Typs übergeben.
set(properties: Interfaces.ChartSeriesUpdateData, options?: OfficeExtension.UpdateOptions): void;
Parameter
- properties
- Excel.Interfaces.ChartSeriesUpdateData
Ein JavaScript-Objekt mit Eigenschaften, die isomorph zu den Eigenschaften des Objekts strukturiert sind, für das die Methode aufgerufen wird.
- options
- OfficeExtension.UpdateOptions
Stellt eine Option zum Unterdrücken von Fehlern bereit, wenn das Eigenschaftenobjekt versucht, schreibgeschützte Eigenschaften festzulegen.
Gibt zurück
void
set(properties)
Legt mehrere Eigenschaften für das -Objekt gleichzeitig fest, basierend auf einem vorhandenen geladenen Objekt.
set(properties: Excel.ChartSeries): void;
Parameter
- properties
- Excel.ChartSeries
Gibt zurück
void
setBubbleSizes(sourceData)
Legt die Blasengrößen für eine Diagrammreihe fest. Funktioniert nur für Blasendiagramme.
setBubbleSizes(sourceData: Range): void;
Parameter
- sourceData
- Excel.Range
Das Range
-Objekt, das den Quelldaten entspricht.
Gibt zurück
void
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-bubble-chart.yaml
await Excel.run(async (context) => {
/*
The table is expected to look like this:
Product, Inventory, Price, Current Market Share
Calamansi, 2000, $2.45, 10%
...
We want each bubble to represent a single row.
*/
// Get the worksheet and table data.
const sheet = context.workbook.worksheets.getItem("Sample");
const table = sheet.tables.getItem("Sales");
const dataRange = table.getDataBodyRange();
// Get the table data without the row names.
const valueRange = dataRange.getOffsetRange(0, 1).getResizedRange(0, -1);
// Create the chart.
const bubbleChart = sheet.charts.add(Excel.ChartType.bubble, valueRange);
bubbleChart.name = "Product Chart";
// Remove the default series, since we want a unique series for each row.
bubbleChart.series.getItemAt(0).delete();
// Load the data necessary to make a chart series.
dataRange.load(["rowCount", "values"]);
await context.sync();
// For each row, create a chart series (a bubble).
for (let i = 0; i < dataRange.rowCount; i++) {
const newSeries = bubbleChart.series.add(dataRange.values[i][0], i);
newSeries.setXAxisValues(dataRange.getCell(i, 1));
newSeries.setValues(dataRange.getCell(i, 2));
newSeries.setBubbleSizes(dataRange.getCell(i, 3));
// Show the product name and market share percentage.
newSeries.dataLabels.showSeriesName = true;
newSeries.dataLabels.showBubbleSize = true;
newSeries.dataLabels.showValue = false;
}
await context.sync();
});
setValues(sourceData)
Legt die Werte für eine Diagrammreihe fest. Bei Punktdiagrammen bezieht er sich auf Werte der Y-Achse.
setValues(sourceData: Range): void;
Parameter
- sourceData
- Excel.Range
Das Range
-Objekt, das den Quelldaten entspricht.
Gibt zurück
void
Hinweise
Beispiele
// Link to full sample: https://raw.githubusercontent.com/OfficeDev/office-js-snippets/prod/samples/excel/10-chart/chart-series.yaml
await Excel.run(async (context) => {
const sheet = context.workbook.worksheets.getItem("Sample");
let seriesCollection = sheet.charts.getItemAt(0);
let rangeSelection = sheet.getRange("C2:C7");
let xRangeSelection = sheet.getRange("A1:A7");
// Add a series.
let newSeries = seriesCollection.series.add("Qtr2");
newSeries.setValues(rangeSelection);
newSeries.setXAxisValues(xRangeSelection);
await context.sync();
});
setXAxisValues(sourceData)
Legt die Werte der X-Achse für eine Diagrammreihe fest.
setXAxisValues(sourceData: Range): void;
Parameter
- sourceData
- Excel.Range
Das Range
-Objekt, das den Quelldaten entspricht.
Gibt zurück
void
Hinweise
toJSON()
Überschreibt die JavaScript-Methode toJSON()
, um eine nützlichere Ausgabe bereitzustellen, wenn ein API-Objekt an JSON.stringify()
übergeben wird. (JSON.stringify
ruft wiederum die toJSON
-Methode des Objekts auf, das an das Objekt übergeben wird.) Während das ursprüngliche Excel.ChartSeries
Objekt ein API-Objekt ist, gibt die toJSON
Methode ein einfaches JavaScript-Objekt (typisiert als Excel.Interfaces.ChartSeriesData
) zurück, das flache Kopien aller geladenen untergeordneten Eigenschaften aus dem ursprünglichen Objekt enthält.
toJSON(): Excel.Interfaces.ChartSeriesData;
Gibt zurück
Office Add-ins