Chart

Chart class

Kapselt das Objekt, das ein einzelnes Excel-Diagramm darstellt.

public class Chart

Eigenschaften

NameBeschreibung
AutoScaling { get; set; }True, wenn Microsoft Excel ein 3D-Diagramm so skaliert, dass es in der Größe näher an dem entsprechenden 2D-Diagramm liegt. Die RightAngleAxes-Eigenschaft muss True sein.
BackWall { get; }Gibt a zurückWalls Objekt, das die Rückwand eines 3D-Diagramms darstellt.
CategoryAxis { get; }Ruft die X-Achse des Diagramms ab.
ChartArea { get; }Ruft den Diagrammbereich im Arbeitsblatt ab.
ChartDataTable { get; }Repräsentiert die Diagrammdatentabelle.
ChartObject { get; }stellt die Diagrammform dar;
DepthPercent { get; set; }Repräsentiert die Tiefe eines 3D-Diagramms als Prozentsatz der Diagrammbreite (zwischen 20 und 2000 Prozent).
DisplayNaAsBlank { get; set; }Gibt an, ob #N/A als Leerwert angezeigt wird.
Elevation { get; set; }Stellt die Höhe der 3D-Kartenansicht in Grad dar.
FirstSliceAngle { get; set; }Liest oder setzt den Winkel des ersten Torten- oder Doughnut-Diagramms in Grad (im Uhrzeigersinn von der Vertikalen). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme, 0 bis 360.
Floor { get; }Gibt a zurückFloor Objekt, das die Wände eines 3D-Diagramms darstellt.
GapDepth { get; set; }Ruft den Abstand zwischen den Datenreihen in einem 3D-Diagramm als Prozentsatz der Markierungsbreite ab oder legt ihn fest. Der Wert dieser Eigenschaft muss zwischen 0 und 500 liegen.
GapWidth { get; set; }Gibt den Abstand zwischen Balken- oder Spaltenclustern als Prozentsatz der Balken- oder Spaltenbreite zurück oder legt ihn fest. Der Wert dieser Eigenschaft muss zwischen 0 und 500 liegen.
HeightPercent { get; set; }Gibt die Höhe eines 3D-Diagramms als Prozentsatz der Diagrammbreite zurück oder legt sie fest (zwischen 5 und 500 Prozent).
HidePivotFieldButtons { get; set; }Gibt an, ob die Feldschaltflächen des Pivot-Diagramms nur ausgeblendet werden, wenn das Diagramm ein PivotChart ist.
Is3D { get; }Gibt an, ob das Diagramm ein 3D-Diagramm ist.
IsRectangularCornered { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Diagrammbereich rechteckig ist. Der Standardwert ist wahr.
Legend { get; }Ruft die Diagrammlegende ab.
Line { get; }Ruft die Leitung ab.
Name { get; set; }Ruft den Namen des Diagramms ab und legt ihn fest.
NSeries { get; }erhält aSeriesCollection Sammlung, die die Datenreihen im Diagramm darstellt.
PageSetup { get; }Stellt die Beschreibung der Seiteneinrichtung in diesem Diagramm dar.
Perspective { get; set; }Gibt die Perspektive für die 3D-Kartenansicht zurück oder legt sie fest. Muss zwischen 0 und 100 liegen. Diese Eigenschaft wird ignoriert, wenn die Eigenschaft RightAngleAxes True ist.
PivotOptions { get; }Gibt die Pivot-Steuerelemente an, die auf dem Diagramm erscheinen
PivotSource { get; set; }Die Quelle sind die Daten der PivotTable. Wenn PivotSource nicht leer ist, ist das Diagramm PivotChart.
Placement { get; set; }Stellt dar, wie das Diagramm mit den darunter liegenden Zellen verbunden ist.
PlotArea { get; }Ruft den Plotbereich des Diagramms ab, der Achsenstrichbeschriftungen enthält.
PlotBy { get; }Ruft ab und legt fest, ob nach Zeile oder Spalte gezeichnet wird.
PlotEmptyCellsType { get; set; }Ruft ab und legt fest, wie die leeren Zellen geplottet werden.
PlotVisibleCells { get; set; }Gibt an, ob nur sichtbare Zellen gezeichnet werden sollen.
PrintSize { get; set; }Ruft die gedruckte Diagrammgröße ab und legt sie fest.
RightAngleAxes { get; set; }Wahr, wenn die Diagrammachsen rechtwinklig sind. Gilt nur für 3D-Diagramme (außer Column3D- und 3D-Kreisdiagramme).
RotationAngle { get; set; }Stellt die Drehung der 3D-Diagrammansicht dar (die Drehung des Diagrammbereichs um die Z-Achse in Grad).
SecondCategoryAxis { get; }Ruft die zweite X-Achse des Diagramms ab.
SecondValueAxis { get; }Ruft die zweite Y-Achse des Diagramms ab.
SeriesAxis { get; }Ruft die Reihenachse des Diagramms ab.
Shapes { get; }Gibt alle Zeichnungsformen in diesem Diagramm zurück.
ShowDataTable { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Diagramm eine Datentabelle anzeigt.
ShowLegend { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Diagrammlegende angezeigt wird. Standard ist wahr.
SideWall { get; }Gibt a zurückWallsObjekt, das die Seitenwand eines 3D-Diagramms darstellt.
SizeWithWindow { get; set; }Wahr, wenn Microsoft Excel die Größe des Diagramms an die Größe des Diagrammblattfensters anpasst.
Style { get; set; }Ruft den integrierten Stil ab und legt ihn fest.
SubTitle { get; }Ruft den Untertitel des Diagramms ab. Nur für Datei im ODS-Format.
Title { get; }Ruft den Titel des Diagramms ab.
Type { get; set; }Ruft den Typ eines Diagramms ab oder legt ihn fest.
ValueAxis { get; }Ruft die Y-Achse des Diagramms ab.
Walls { get; }Gibt a zurückWalls Objekt, das die Wände eines 3D-Diagramms darstellt.
WallsAndGridlines2D { get; set; }Wahr, wenn Gitternetzlinien zweidimensional auf einem 3D-Diagramm gezeichnet werden.
Worksheet { get; }Ruft das Arbeitsblatt ab, das dieses Diagramm enthält.

Methoden

NameBeschreibung
Calculate()Berechnet die benutzerdefinierte Position des Plotbereichs, Achsen, wenn deren Position automatisch zugewiesen wird.
GetActualSize()Ruft die tatsächliche Größe des Diagramms in Pixeleinheiten ab.
GetChartDataRange()Ruft den Datenquellenbereich des Diagramms ab.
HasAxis(AxisType, bool)Gibt zurück, welche Achsen im Diagramm vorhanden sind.
IsChartDataChanged()Erkennt, ob sich die Datenquelle eines Diagramms geändert hat.
Move(int, int, int, int)Verschiebt das Diagramm an eine bestimmte Position.
RefreshPivotData()Aktualisiert die Daten des Pivot-Diagramms aus seiner Pivot-Datenquelle.
SetChartDataRange(string, bool)Gibt den Datenbereich für ein Diagramm an.
SwitchRowColumn()Wechselt Zeile/Spalte.
ToImage()Ruft eine 32-Bit-Version abBitmap Objekt des Diagramms.
ToImage(ImageOrPrintOptions)Ruft eine 32-Bit-Version abBitmap Objekt des Diagramms. ImageOrPrintOptions.ImageFormat , ImageOrPrintOptions.TiffCompression und ImageOrPrintOptions.Quality werden ignoriert.
ToImage(string)Erstellt das Diagrammbild und speichert es in einer Datei. Die Erweiterung des Dateinamens bestimmt das Format des Bildes.
ToImage(Stream, ImageOrPrintOptions)Erstellt das Diagrammbild und speichert es in einem Stream im angegebenen Format.
ToImage(Stream, ImageType)Erstellt das Diagrammbild und speichert es in einem Stream im angegebenen Format.
ToImage(Stream, long)Erstellt das Diagrammbild und speichert es in einem Stream im JPEG-Format.
ToImage(string, ImageOrPrintOptions)Erstellt das Diagrammbild und speichert es in einer Datei. Die Erweiterung des Dateinamens bestimmt das Format des Bildes.
ToImage(string, ImageType)Erstellt das Diagrammbild und speichert es in einer Datei im angegebenen Bildtyp.
ToImage(string, long)Erstellt das Diagrammbild und speichert es in einer Datei im JPEG-Format.
ToPdf(Stream)Erstellt das Diagramm-PDF und speichert es in einem Stream.
ToPdf(string)Speichert das Diagramm in einer PDF-Datei.
ToPdf(Stream, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Erstellt das Diagramm-PDF und speichert es in einem Stream.
ToPdf(string, float, float, PageLayoutAlignmentType, PageLayoutAlignmentType)Speichert das Diagramm in einer PDF-Datei.

Beispiele

[C#]

Workbook workbook = new Workbook();
Worksheet sheet = workbook.Worksheets[0];

Cells cells = sheet.Cells;
cells[0,1].PutValue("Income");
cells[1,0].PutValue("Company A");
cells[2,0].PutValue("Company B");
cells[3,0].PutValue("Company C");
cells[1,1].PutValue(10000);
cells[2,1].PutValue(20000);
cells[3,1].PutValue(30000);
		
int chartIndex = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15);

Chart chart = sheet.Charts[chartIndex];
chart.SetChartDataRange("A1:B4", true);
chart.ShowLegend = true;
chart.Title.Text = "Income Analysis";

[Visual Basic]

Dim workbook as Workbook = new Workbook()
Dim sheet as Worksheet = workbook.Worksheets(0)

Dim cells as Cells = sheet.Cells
cells(0,1).PutValue("Income")
cells(1,0).PutValue("Company A")
cells(2,0).PutValue("Company B")
cells(3,0).PutValue("Company C")
cells(1,1).PutValue(10000)
cells(2,1).PutValue(20000)
cells(3,1).PutValue(30000)
		
Dim chartIndex as Integer = sheet.Charts.Add(ChartType.Column, 9, 9, 21, 15)

Dim chart as Chart = sheet.Charts(chartIndex) 
chart.SetChartDataRange("A1:B4", True);
chart.ShowLegend = True
chart.Title.Text = "Income Analysis"

Siehe auch