Diagramm

Diagramm hinzufügen

func (f *File) AddChart(sheet, cell string, chart *ChartOptions, combo ...*ChartOptions) error

AddChart bietet die Methode zum Hinzufügen eines Diagramms zu einem Arbeitsblatt anhand eines bestimmten Diagrammformatsatzes (z. B. Versatz, Skalierung, Seitenverhältniseinstellung und Druckeinstellungen) und festgelegter Eigenschaften.

Das Folgende zeigt den Type des Diagramms, das von Excelize unterstützt wird:

Im Office Excel-Diagrammdatenbereich gibt Series den Informationssatz an, für den Daten gezeichnet werden sollen, das Legendenelement (Serie) und die horizontale (Kategorie) Achsenbeschriftung.

Folgende Optionen können für die Series eingestellt werden:

Legen Sie die Eigenschaften der Diagrammlegende fest. Folgende Optionen können eingestellt werden:

Stellen Sie die Position der Diagrammlegende ein. Die Standard-Legendenposition ist right. Die verfügbaren Positionen sind:

Der Parametersatz ShowLegendKey der Legendenschlüssel soll in Datenbeschriftungen angezeigt werden. Der Standardwert ist false.

Die Eigenschaften des Diagrammtitels werden über das Feld Title mit dem Datentyp ChartTitle festgelegt. Folgende Eigenschaften können festgelegt werden:

Der Parameter ShowBlanksAs liefert die Einstellung "Zellen ausblenden und leeren". Der Standardwert ist: gap. In der Excel-Anwendung wird "leere Zelle als" angezeigt: "Leerzeichen". Die folgenden Werte sind für diesen Parameter optional:

Legen Sie die Diagrammlegende für alle Datenreihen mit der Eigenschaft Legend fest. Die Eigenschaft Legend ist optional.

Legen Sie die Blasengröße in allen Datenreihen für das Blasendiagramm oder 3D-Blasendiagramm mit der Eigenschaft BubbleSizes fest. Die Eigenschaft BubbleSizes ist optional. Die Standardbreite ist 100 und der Wert sollte größer als 0 und kleiner oder gleich 300 sein.

Legen Sie die Donut-Lochgröße in allen Datenreihen für das Donut-Diagramm mit der Eigenschaft HoleSize fest. Die Eigenschaft HoleSize ist optional. Die Standardbreite ist 75 und der Wert sollte größer als 0 und kleiner oder gleich 90 sein.

Gibt an, dass jede Datenpunktmarkierung in der Reihe eine andere Farbe durch VaryColors hat. Der Standardwert ist true.

Der Parameter Format bietet Einstellungen für Parameter wie Diagrammversatz, Skalierung, Seitenverhältniseinstellungen und Druckeigenschaften sowie für die in der Funktion AddPicture verwendeten.

Die Eigenschaften des Diagrammbereichs werden über das Feld PlotArea mit dem Datentyp ChartPlotArea festgelegt. Folgende Eigenschaften können festgelegt werden:

Stellen Sie die primären Optionen für die horizontale und vertikale Achse auf XAxis und YAxis ein.

Die Eigenschaften von XAxis, die eingestellt werden können, sind:

Die Eigenschaften von YAxis, die eingestellt werden können, sind:

Der Wert von TextRotation kann von -90 bis 90 eingestellt werden.

Die folgenden Werte für Vertical können festgelegt werden: horz, vert, vert270, wordArtVert, eaVert, mongolianVert und wordArtVertRtl.

Legen Sie die Diagrammgröße anhand der Eigenschaft Dimension fest. Die Dimensionseigenschaft ist optional. Folgende Eigenschaften können festgelegt werden:

Der Parameter combo gibt an, dass ein Diagramm erstellt wird, das zwei oder mehr Diagrammtypen in einem einzelnen Diagramm kombiniert. Erstellen Sie beispielsweise ein gruppiertes Spalten-Liniendiagramm mit den Daten Sheet1!$E$1:$L$15:

package main

import (
    "fmt"

    "github.com/xuri/excelize/v2"
)

func main() {
    f := excelize.NewFile()
    defer func() {
        if err := f.Close(); err != nil {
            fmt.Println(err)
        }
    }()
    if err := f.SetSheetName("Sheet1", "Tabelle1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Apfel", "Orange", "Birne"},
        {"Klein", 2, 3, 3},
        {"Normal", 5, 2, 4},
        {"Groß", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Tabelle1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Tabelle1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Tabelle1!$A$2",
                Categories: "Tabelle1!$B$1:$D$1",
                Values:     "Tabelle1!$B$2:$D$2",
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Title: excelize.ChartTitle{
            Paragraph: []excelize.RichTextRun{
                {
                    Text: "Clustered Column - Liniendiagramm",
                },
            },
        },
        Legend: excelize.ChartLegend{
            Position: "left",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }, &excelize.Chart{
        Type: excelize.Line,
        Series: []excelize.ChartSeries{
            {
                Name:       "Tabelle1!$A$4",
                Categories: "Tabelle1!$B$1:$D$1",
                Values:     "Tabelle1!$B$4:$D$4",
                Marker: excelize.ChartMarker{
                    Symbol: "none", Size: 10,
                },
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Legend: excelize.ChartLegend{
            Position: "right",
        },
        PlotArea: excelize.ChartPlotArea{
            ShowCatName:     false,
            ShowLeaderLines: false,
            ShowPercent:     true,
            ShowSerName:     true,
            ShowVal:         true,
        },
    }); err != nil {
        fmt.Println(err)
        return
    }
    // Speichern Sie die Tabelle unter dem angegebenen Pfad.
    if err := f.SaveAs("Mappe1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Diagrammblatt hinzufügen

func (f *File) AddChartSheet(sheet string, chart *ChartOptions, combo ...*ChartOptions) error

AddChartSheet bietet die Methode zum Erstellen eines Diagrammblatts anhand eines bestimmten Diagrammformatsatzes (z. B. Versatz, Skalierung, Einstellung des Seitenverhältnisses und Druckeinstellungen) und festgelegter Eigenschaften. In Excel ist ein Diagrammblatt ein Arbeitsblatt, das nur ein Diagramm enthält.

Diagramm löschen

func (f *File) DeleteChart(sheet, cell string) error

DeleteChart bietet eine Funktion zum Löschen von Diagrammen in einer Tabelle anhand des angegebenen Arbeitsblatts und des Zellennamens.