Chart Klasse

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

Der Typ Chart macht die folgenden Member verfügbar:

Eigenschaften

Eigentum	Beschreibung
style	Ruft den integrierten Stil ab und legt ihn fest.
chart_object	Stellt die Diagrammform dar;
hide_pivot_field_buttons	Gibt an, ob die Schaltflächen der PivotChart-Felder nur ausgeblendet werden sollen, wenn es sich bei dem Diagramm um ein PivotChart handelt.
pivot_options	Gibt die Pivot-Steuerelemente an, die im Diagramm angezeigt werden
pivot_source	Als Quelle dienen die Daten der PivotTable. Wenn PivotSource nicht leer ist, ist das Diagramm ein PivotChart.
plot_by	Ruft ab und legt fest, ob die Darstellung zeilen- oder spaltenweise erfolgt.
plot_empty_cells_type	Ruft ab und legt fest, wie die leeren Zellen dargestellt werden.
plot_visible_cells	Gibt an, ob nur sichtbare Zellen dargestellt werden.
plot_visible_cells_only	Gibt an, ob nur sichtbare Zellen dargestellt werden sollen.
display_na_as_blank	Gibt an, ob #N/A als leerer Wert angezeigt wird.
name	Ruft den Namen des Diagramms ab und legt ihn fest.
size_with_window	Wahr, wenn Microsoft Excel die Größe des Diagramms an die Größe des Diagrammblattfensters anpasst.
worksheet	Ruft das Arbeitsblatt ab, das dieses Diagramm enthält.
shapes	Gibt alle Zeichenformen in diesem Diagramm zurück.
print_size	Ruft die Größe des gedruckten Diagramms ab und legt sie fest.
type	Ruft den Typ eines Diagramms ab oder legt ihn fest.
n_series	Ruft eine `SeriesCollection`-Sammlung ab, die die Datenreihe im Diagramm darstellt.
filtered_n_series	Ruft eine `SeriesCollection`-Sammlung ab, die die im Diagramm gefilterten Datenreihen darstellt.
title	Ruft den Titel des Diagramms ab.
sub_title	Ruft den Untertitel des Diagramms ab. Nur für Dateien im Format ODS.
plot_area	Ruft den Zeichnungsbereich des Diagramms ab, der die Beschriftungen der Achsenmarkierungen enthält.
chart_area	Ruft den Diagrammbereich im Arbeitsblatt ab.
category_axis	Ruft die X-Achse des Diagramms ab.
value_axis	Ruft die Y-Achse des Diagramms ab.
second_value_axis	Ruft die zweite Y-Achse des Diagramms ab.
second_category_axis	Ruft die zweite X-Achse des Diagramms ab.
series_axis	Ruft die Serienachse des Diagramms ab.
legend	Ruft die Diagrammlegende ab.
chart_data_table	Stellt die Diagrammdatentabelle dar.
show_legend	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob die Diagrammlegende angezeigt wird. Der Standardwert ist „true“.
is_rectangular_cornered	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob der Diagrammbereich rechteckige Ecken hat. Der Standardwert ist „true“.
show_data_table	Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob das Diagramm eine Datentabelle anzeigt.
first_slice_angle	Ruft den Winkel des ersten Kreis- oder Ringdiagrammsegments in Grad ab oder legt ihn fest (im Uhrzeigersinn von der Vertikalen). Gilt nur für Kreis-, 3D-Kreis- und Ringdiagramme (0 bis 360).
gap_width	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.
gap_depth	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.
floor	Gibt ein `Chart.floor`-Objekt zurück, das die Wände eines 3D-Diagramms darstellt.
walls	Gibt ein `Chart.walls`-Objekt zurück, das die Wände eines 3D-Diagramms darstellt.
back_wall	Gibt ein `Chart.walls`-Objekt zurück, das die Rückwand eines 3D-Diagramms darstellt.
side_wall	Gibt ein `Chart.walls`-Objekt zurück, das die Seitenwand eines 3D-Diagramms darstellt.
walls_and_gridlines_2d	Wahr, wenn Gitternetzlinien in einem 3D-Diagramm zweidimensional gezeichnet werden.
rotation_angle	Stellt die Drehung der 3D-Diagrammansicht dar (die Drehung des Zeichnungsbereichs um die Z-Achse in Grad).
elevation	Stellt die Höhe der 3D-Kartenansicht in Grad dar.
right_angle_axes	Wahr, wenn die Diagrammachsen im rechten Winkel verlaufen. Gilt nur für 3D-Diagramme (außer Column3D und 3D-Kreisdiagramme).
auto_scaling	Wahr, wenn Microsoft Excel ein 3D-Diagramm so skaliert, dass es in der Größe näher an das entsprechende 2D-Diagramm heranreicht. Die RightAngleAxes-Eigenschaft muss True sein.
height_percent	Gibt die Höhe eines 3D-Diagramms als Prozentsatz der Diagrammbreite zurück oder legt sie fest (zwischen 5 und 500 Prozent).
perspective	Gibt die Perspektive für die 3D-Diagrammansicht zurück oder legt sie fest. Der Wert muss zwischen 0 und 100 liegen. Diese Eigenschaft wird ignoriert, wenn die RightAngleAxes-Eigenschaft True ist.
is_3d	Gibt an, ob es sich bei dem Diagramm um ein 3D-Diagramm handelt.
depth_percent	Stellt die Tiefe eines 3D-Diagramms als Prozentsatz der Diagrammbreite dar (zwischen 20 und 2000 Prozent).
actual_chart_size	Ruft die tatsächliche Größe des Diagramms in Pixeln ab.
placement	Stellt dar, wie das Diagramm mit den darunterliegenden Zellen verbunden ist.
page_setup	Stellt die Seiteneinrichtungsbeschreibung in diesem Diagramm dar.
line	Ruft die Zeile ab.

Methoden

Methode	Beschreibung
`calculate(self)`	Berechnet die benutzerdefinierte Position des Plotbereichs und der Achsen, wenn deren Position automatisch zugewiesen wird.
`calculate(self, calculate_options)`	Berechnet die benutzerdefinierte Position des Zeichnungsbereichs und der Achsen, wenn deren Position automatisch zugewiesen wird, mit den Diagrammberechnungsoptionen.
`to_image(self, image_file)`	Erstellt das Diagrammbild und speichert es in einer Datei. Die Erweiterung des Dateinamens bestimmt das Format des Bildes.
`to_image(self, image_file, image_type)`	Erstellt das Diagrammbild und speichert es in einer Datei im angegebenen Bildtyp.
`to_image(self, image_file, jpeg_quality)`	Erstellt das Diagrammbild und speichert es in einer Datei im JPEG-Format.
`to_image(self, stream, jpeg_quality)`	Erstellt das Diagrammbild und speichert es in einem Stream im JPEG-Format.
`to_image(self, stream, image_type)`	Erstellt das Diagrammbild und speichert es im angegebenen Format in einem Stream.
`to_image(self, image_file, options)`	Erstellt das Diagrammbild und speichert es in einer Datei. Die Erweiterung des Dateinamens bestimmt das Format des Bildes.
`to_image(self, stream, options)`	Erstellt das Diagrammbild und speichert es im angegebenen Format in einem Stream.
`to_pdf(self, file_name)`	Speichert das Diagramm in einer PDF-Datei.
`to_pdf(self, file_name, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`	Speichert das Diagramm in einer PDF-Datei.
`to_pdf(self, stream)`	Erstellt das Diagramm-PDF und speichert es in einem Stream.
`to_pdf(self, stream, desired_page_width, desired_page_height, h_alignment_type, v_alignment_type)`	Erstellt das Diagramm-PDF und speichert es in einem Stream.
`is_refered_by_chart(self, row_index, column_index)`	Gibt zurück, ob die Zelle vom Diagramm referenziert wird.
`is_cell_refered_by_chart(self, sheet_index, row_index, column_index)`	Gibt zurück, ob die Zelle vom Diagramm referenziert wird.
`is_chart_data_changed(self)`	Erkennt, ob sich die Datenquelle eines Diagramms geändert hat.
`refresh_pivot_data(self)`	Aktualisiert die Diagrammdaten aus der Pivot-Tabelle.
`change_template(self, data)`	Ändern Sie den Diagrammtyp mit einer voreingestellten Vorlage.
`move(self, upper_left_row, upper_left_column, lower_right_row, lower_right_column)`	Verschiebt das Diagramm an eine angegebene Position.
`get_actual_size(self)`	Ruft die tatsächliche Größe des Diagramms in Pixeln ab.
`has_axis(self, aixs_type, is_primary)`	Gibt zurück, welche Achsen im Diagramm vorhanden sind.
`switch_row_column(self)`	Vertauscht Zeile/Spalte.
`get_chart_data_range(self)`	Ruft den Datenquellenbereich des Diagramms ab.
`set_chart_data_range(self, area, is_vertical)`	Gibt den Datenbereich für ein Diagramm an.

Beispiel

Die folgenden Codes zeigen, wie Sie mit .Net-Codes ein Diagramm erstellen.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType

workbook = Workbook()
sheet = workbook.worksheets[0]
cells = sheet.cells
cells.get(0, 1).put_value("Income")
cells.get(1, 0).put_value("Company A")
cells.get(2, 0).put_value("Company B")
cells.get(3, 0).put_value("Company C")
cells.get(1, 1).put_value(10000)
cells.get(2, 1).put_value(20000)
cells.get(3, 1).put_value(30000)
chartIndex = sheet.charts.add(ChartType.COLUMN, 9, 9, 21, 15)
chart = sheet.charts[chartIndex]
chart.set_chart_data_range("A1:B4", True)
chart.show_legend = True
chart.title.text = "Income Analysis"

Siehe auch

Modul aspose.cells.charts
Klasse SeriesCollection

AxisBins Klasse ChartArea Klasse