AddChart

AddChart(ChartType, float, float, float, float)

Erstellt ein neues Diagramm, initialisiert es mit Beispielseriendaten und -einstellungen und fügt es am Ende der Sammlung hinzu.

public IChart AddChart(ChartType type, float x, float y, float width, float height)
ParameterTypBeschreibung
typeChartTypeTyp des Diagramms.
xSingleX-Koordinate eines neuen Diagramms.
ySingleY-Koordinate eines neuen Diagramms.
widthSingleBreite des Diagramms.
heightSingleHöhe des Diagramms.

Rückgabewert

Erstelltes Diagramm.

Beispiele

Das folgende Beispiel zeigt, wie man ein Diagramm in einer PowerPoint-Präsentation erstellt.

[C#]
// Instanziiert die Presentation-Klasse, die eine PPTX-Datei darstellt
using(Presentation pres = new Presentation()) {
  // Greift auf die erste Folie zu
  ISlide sld = pres.Slides[0];
  // Fügt ein Diagramm mit seinen Standarddaten hinzu
  IChart chart = sld.Shapes.AddChart(ChartType.ClusteredColumn, 0, 0, 500, 500);
  // Setzt den Diagrammtitel
  chart.ChartTitle.AddTextFrameForOverriding("Beispiel Titel");
  chart.ChartTitle.TextFrameForOverriding.TextFrameFormat.CenterText = NullableBool.True;
  chart.ChartTitle.Height = 20;
  chart.HasTitle = true;
  // Setzt die erste Serie, um Werte anzuzeigen
  chart.ChartData.Series[0].Labels.DefaultDataLabelFormat.ShowValue = true;
  // Setzt den Index für das Diagramm-Datenblatt
  int defaultWorksheetIndex = 0;
  // Erhält das Diagramm-Datenarbeitsbuch
  IChartDataWorkbook fact = chart.ChartData.ChartDataWorkbook;
  // Löscht die standardmäßig generierten Serien und Kategorien
  chart.ChartData.Series.Clear();
  chart.ChartData.Categories.Clear();
  int s = chart.ChartData.Series.Count;
  s = chart.ChartData.Categories.Count;
  // Fügt neue Serien hinzu
  chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 1, "Serie 1"), chart.Type);
  chart.ChartData.Series.Add(fact.GetCell(defaultWorksheetIndex, 0, 2, "Serie 2"), chart.Type);
  // Fügt neue Kategorien hinzu
  chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 1, 0, "Kategorie 1"));
  chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 2, 0, "Kategorie 2"));
  chart.ChartData.Categories.Add(fact.GetCell(defaultWorksheetIndex, 3, 0, "Kategorie 3"));
  // Nimmt die erste Diagrammserie
  IChartSeries series = chart.ChartData.Series[0];
  // Füllt die Seriendaten
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 1, 1, 20));
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 2, 1, 50));
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 3, 1, 30));
  // Setzt die Füllfarbe für die Serie
  series.Format.Fill.FillType = FillType.Solid;
  series.Format.Fill.SolidFillColor.Color = Color.Red;
  // Nimmt die zweite Diagrammserie
  series = chart.ChartData.Series[1];
  // Füllt die Seriendaten
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 1, 2, 30));
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 2, 2, 10));
  series.DataPoints.AddDataPointForBarSeries(fact.GetCell(defaultWorksheetIndex, 3, 2, 60));
  // Setzt die Füllfarbe für die Serie
  series.Format.Fill.FillType = FillType.Solid;
  series.Format.Fill.SolidFillColor.Color = Color.Green;
  // Setzt das erste Label, um den Kategorienamen anzuzeigen
  IDataLabel lbl = series.DataPoints[0].Label;
  lbl.DataLabelFormat.ShowCategoryName = true;
  lbl = series.DataPoints[1].Label;
  lbl.DataLabelFormat.ShowSeriesName = true;
  // Setzt die Serie, um den Wert für das dritte Label anzuzeigen
  lbl = series.DataPoints[2].Label;
  lbl.DataLabelFormat.ShowValue = true;
  lbl.DataLabelFormat.ShowSeriesName = true;
  lbl.DataLabelFormat.Separator = "/";
  // Speichert die PPTX-Datei auf der Festplatte
  pres.Save("AsposeChart_out.pptx", SaveFormat.Pptx);
}

Siehe auch


AddChart(ChartType, float, float, float, float, bool)

Erstellt ein neues Diagramm und fügt es am Ende der Sammlung hinzu.

public IChart AddChart(ChartType type, float x, float y, float width, float height, 
    bool initWithSample)
ParameterTypBeschreibung
typeChartTypeTyp des Diagramms.
xSingleX-Koordinate eines neuen Diagramms.
ySingleY-Koordinate eines neuen Diagramms.
widthSingleBreite des Diagramms.
heightSingleHöhe des Diagramms.
initWithSampleBooleanWenn true, wird das neue Diagramm mit Beispielseriendaten und -einstellungen initialisiert. Wenn false, hat das neue Diagramm keine Serien und minimale Einstellungen. In diesem Fall ist die Erstellung des Diagramms schneller.

Rückgabewert

Erstelltes Diagramm.

Siehe auch