Grafico

Aggiungi grafico

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

AddChart fornisce il metodo per aggiungere un grafico in un foglio di lavoro in base al formato del grafico specificato (come offset, scala, impostazione delle proporzioni e impostazioni di stampa) e alle proprietà impostate.

Di seguito viene mostrato il Type di grafico supportato da Excelize:

Nell'intervallo di dati del grafico di Office Excel, Series specifica l'insieme di informazioni per cui i dati tracciare, l'elemento della legenda (serie) e l'etichetta dell'asse orizzontale (categoria).

Le opzioni Series che possono essere impostate sono:

Imposta le proprietà della legenda del grafico. Le opzioni che è possibile impostare sono:

Imposta la Position della legenda del grafico. La posizione predefinita della legenda è right. Questo parametro ha effetto solo quando None è false. Le posizioni disponibili sono:

Il parametro ShowLegendKey imposta le chiavi della legenda devono essere mostrate nelle etichette dei dati. Il valore predefinito è false.

Il titolo del grafico viene impostato selezionando il parametro Name dell'oggetto Title e il titolo verrà visualizzato sopra il grafico. Il parametro Name supporta l'uso di rappresentazioni di formule, come Foglio1!$A$1, se non specifichi il titolo di un'icona, il valore predefinito è null.

Il parametro ShowBlanksAs fornisce l'impostazione "Nascondi e svuota celle". Il valore predefinito è: gap. Nell'applicazione Excel "la cella vuota viene visualizzata come": "spazio". I seguenti sono valori facoltativi per questo parametro:

Imposta la dimensione della bolla in tutte le serie di dati per il grafico a bolle o il grafico a bolle 3D tramite la proprietà BubbleSizes. La proprietà BubbleSizes è facoltativa. La larghezza predefinita è 100 e il valore deve essere maggiore di 0 e minore o uguale a 300.

Imposta la dimensione del foro della ciambella in tutte le serie di dati per il grafico a ciambella tramite la proprietà HoleSize. La proprietà HoleSize è facoltativa. La larghezza predefinita è 75 e il valore deve essere maggiore di 0 e inferiore o uguale a 90.

Specifica che ciascun indicatore di dati nella serie ha un colore diverso da VaryColors. Il valore predefinito è true.

Il parametro Format fornisce impostazioni per parametri quali offset del grafico, scala, impostazioni del rapporto d'aspetto e proprietà di stampa, nonché quelli utilizzati nella funzione AddPicture.

Imposta la posizione dell'area del grafico in base all'area del grafico. Le proprietà che è possibile impostare sono:

Imposta le opzioni dell'asse orizzontale e verticale primario con XAxis e YAxis.

Le proprietà di XAxis che possono essere impostate sono:

Le proprietà di YAxis che possono essere impostate sono:

Il valore di TextRotation può essere impostato da -90 a 90.

I valori di Vertical che possono essere impostati sono: horz, vert, vert270, wordArtVert, eaVert, mongolianVert e wordArtVertRtl.

Imposta la dimensione del grafico tramite la proprietà Dimension. La proprietà dimensione è facoltativa. Le proprietà che è possibile impostare sono:

Il parametro combo specifica la creazione di un grafico che combina due o più tipi di grafico in un unico grafico. Ad esempio, crea un grafico a linee e colonne raggruppate con i dati Foglio1!$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", "Foglio1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Mela", "Arancia", "Pera"},
        {"Piccolo", 2, 3, 3},
        {"Normale", 5, 2, 4},
        {"Grande", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Foglio1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Foglio1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Foglio1!$A$2",
                Categories: "Foglio1!$B$1:$D$1",
                Values:     "Foglio1!$B$2:$D$2",
            },
        },
        Format: excelize.GraphicOptions{
            ScaleX:          1,
            ScaleY:          1,
            OffsetX:         15,
            OffsetY:         10,
            PrintObject:     &enable,
            LockAspectRatio: false,
            Locked:          &disable,
        },
        Title: []excelize.RichTextRun{
            {
                Text: "Colonne raggruppate - Grafico a linee",
            },
        },
        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:       "Foglio1!$A$4",
                Categories: "Foglio1!$B$1:$D$1",
                Values:     "Foglio1!$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
    }
    // Salva il foglio di calcolo seguendo il percorso indicato.
    if err := f.SaveAs("Cartel1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Aggiungi foglio grafico

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

AddChartSheet fornisce il metodo per creare un foglio grafico in base al formato del grafico impostato (come offset, scala, impostazione delle proporzioni e impostazioni di stampa) e alle proprietà impostate. In Excel un foglio grafico è un foglio di lavoro che contiene solo un grafico.

Elimina grafico

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

DeleteChart fornisce una funzione per eliminare il grafico nel foglio di calcolo in base al nome del foglio di lavoro e al riferimento alla cella.