Graphique

Ajouter un graphique

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

AddChart fournit la méthode pour ajouter un graphique dans une feuille en fonction d'un ensemble de formats de graphique donné (tel que le décalage, l'échelle, le paramètre de rapport d'aspect et les paramètres d'impression) et le jeu de propriétés.

Voici le Type de graphique supporté par excelize:

ID Énumération Graphique
0 Area 2D graphique à aires
1 AreaStacked 2D graphique à aires empilées
2 AreaPercentStacked 2D 100% graphique à aires empilées
3 Area3D 3D graphique à aires
4 Area3DStacked 3D graphique à aires empilées
5 Area3DPercentStacked 3D 100% graphique à aires empilées
6 Bar 2D graphique à barres en cluster
7 BarStacked 2D graphique à barres empilées
8 BarPercentStacked 2D 100% graphique à barres empilées
9 Bar3DClustered 3D graphique à barres en cluster
10 Bar3DStacked 3D graphique à barres empilées
11 Bar3DPercentStacked 3D 100% graphique à barres empilées
12 Bar3DConeClustered 3D graphique à barres groupée de cône
13 Bar3DConeStacked 3D graphique à barres empilés de cône
14 Bar3DConePercentStacked 3D graphique à barres cône
15 Bar3DPyramidClustered 3D graphique à barres groupée pyramide
16 Bar3DPyramidStacked 3D graphique de barre empilé de pyramide
17 Bar3DPyramidPercentStacked 3D 100% graphique à barres empilées pyramide
18 Bar3DCylinderClustered 3D graphique à barres groupée de cylindres
19 Bar3DCylinderStacked 3D graphique à barres empilés de cylindre
20 Bar3DCylinderPercentStacked 3D 100% graphique à barres cylindre empilées
21 Col 2D tableau à colonnes groupées
22 ColStacked 2D graphique à colonnes empilées
23 ColPercentStacked 2D 100% graphique à colonnes empilées
24 Col3D 3D graphique à colonnes
25 Col3DClustered 3D tableau à colonnes groupées
26 Col3DStacked 3D graphique à colonnes empilées
27 Col3DPercentStacked 3D 100% graphique à colonnes empilées
28 Col3DCone 3D graphique de colonne de cône
29 Col3DConeClustered 3D graphique de colonne groupé de cône
30 Col3DConeStacked 3D graphique de colonne empilé de cône
31 Col3DConePercentStacked 3D 100% graphique de colonne empilé cône empilé
32 Col3DPyramid 3D graphique de colonne de pyramide
33 Col3DPyramidClustered 3D graphique de colonne groupé de pyramide
34 Col3DPyramidStacked 3D graphique de colonne empilé de pyramide
35 Col3DPyramidPercentStacked 3D 100% graphique de colonne empilée pyramide
36 Col3DCylinder 3D graphique de colonne de cylindre
37 Col3DCylinderClustered 3D graphique de colonne groupé de cylindre
38 Col3DCylinderStacked 3D graphique de colonne empilé de cylindre
39 Col3DCylinderPercentStacked 3D 100 graphique de colonne cylindre empilé
40 Doughnut tableau de donut
41 Line graphique en ligne
42 Line3D 3D graphique en ligne
43 Pie graphique tarte
44 Pie3D 3D graphique tarte
45 PieOfPie double du camembert
46 BarOfPie barre de camembert
47 Radar graphique radar
48 Scatter graphique de dispersion
49 Surface3D 3D graphique de surface
50 WireframeSurface3D 3D graphique de surface de fil
51 Contour graphique de contour
52 WireframeContour graphique de contour de trame de fil
53 Bubble graphique à bulles
54 Bubble3D 3D graphique à bulles
55 StockHighLowClose Graphique boursier Haut-Bas-Fermé
56 StockOpenHighLowClose Graphique boursier Open-Haut-Bas-Fermé

Dans la zone de données de graphique Office Excel Series spécifie l'ensemble des informations pour lesquelles les données doivent être dessinées, l'élément de légende (série) et l'étiquette d'axe horizontal (catégorie).

Les options Series qui peuvent être définies sont:

Paramètre Explication
Name Élément de légende (série), affiché dans la légende du graphique et la barre de formule. Le paramètre Name est facultatif. Si vous ne spécifiez pas cette valeur, la valeur par défaut sera Series 1 .. n. Support Name pour la représentation de la formule, par exemple: Sheet1!$A$1.
Categories Etiquette d'axe horizontal (catégorie). Le paramètre Categories est facultatif dans la plupart des types de graphiques, la valeur par défaut est une séquence contiguë de la forme 1..n.
Values La zone de données de graphique, qui est le paramètre le plus important dans Series, est également le seul paramètre requis lors de la création d'un graphique. Cette option lie le graphique aux données de la feuille de calcul qu'il affiche.
Legend Cette propriété définit la police du texte de légende d'une série de données. La propriété Legend est facultative.
Fill Ceci définit le format de remplissage de la série de données.
Line Ceci définit le format de ligne du graphique en courbes. La propriété Line est facultative et si elle n'est pas fournie, le style par défaut. Les options pouvant être définies sont Width. La plage de Width est comprise entre 0.25 et 999 pt. Si la valeur de width est en dehors de la plage, la largeur par défaut de la ligne est de 2 pt.
Marker Ceci définit le marqueur du graphique linéaire et du nuage de points. La plage du champ facultatif Size est comprise entre 2 et 72 (la valeur par défaut est 5). La valeur d'énumération du champ facultatif Symbol est (la valeur par défaut est auto): circle, dash, diamond, dot, none, picture, plus, square, star, triangle, x, auto.
DataLabelPosition Ceci définit la position de l'étiquette de données de la série de graphiques.
DataPoint Ceci définit le format des points de données individuels dans une série de graphiques en anneau, en secteur ou en secteur 3D. La propriété DataPoint est facultative.

Définir les propriétés de la légende du graphique. Les options qui peuvent être définies sont:

Paramètre Type Explication
Position string La position de la légende du graphique
ShowLegendKey bool Définir les clés de légende doivent être affichées dans les étiquettes de données
Font Font Définissez les propriétés de police du texte de la légende du graphique. Les propriétés sont identiques à celles de l'objet police utilisé pour la mise en forme des cellules. Vous pouvez définir la famille de police, la taille, la couleur, le gras, l'italique, le soulignement et le barré

Définissez la Position de la légende du graphique. La position par défaut de la légende est right. Les postes disponibles sont:

Paramètre Explication
none Désactiver la légende
top En haut
bottom Au fond
left Sur la gauche
right Sur la droite
top_right En haut à droite

Le paramètre ShowLegendKey défini les clés de légende doit être affiché dans les étiquettes de données. La valeur par défaut est false.

Définissez les propriétés du titre du graphique à l'aide du champ Title de type ChartTitle. Les propriétés configurables sont:

Paramètre Type Explication
Fill Fill Définissez la couleur de remplissage du titre du graphique. La propriété Fill est facultative.
Border LineOptions Définissez la bordure du titre du graphique; les propriétés configurables sont identiques à celles de l'objet de bordure utilisé pour la mise en forme des cellules. La propriété Border est facultative.
Paragraph []RichTextRun Définissez le format de texte enrichi du titre du graphique. La propriété Paragraph est facultative et ne peut pas être définie simultanément avec la propriété Formula.
Font *Font Définissez les propriétés de police du texte de la formule du titre du graphique. La propriété Font est facultative.
Formula string Définissez la formule du texte du titre du graphique. Par exemple: Sheet1!$A$1. La propriété Formula est facultative et ne peut pas être définie simultanément avec la propriété Paragraph.
OffsetX int Définissez le décalage horizontal du titre du graphique. La propriété OffsetX est facultative. Sa valeur par défaut est 0 et elle doit être un entier compris entre 0 et 100.
OffsetY int Définissez le décalage vertical du titre du graphique. La propriété OffsetY est facultative. Sa valeur par défaut est 0 et elle doit être un entier compris entre 0 et 100.
Width int Définissez la largeur du titre du graphique. La propriété Width est facultative. Sa valeur par défaut est 0 et elle doit être un entier compris entre 0 et 100.
Height int Définissez la hauteur du titre du graphique. La propriété Height est facultative. Sa valeur par défaut est 0 et elle doit être un entier compris entre 0 et 100.
Overlay bool Afficher le titre du graphique en surimpression. La propriété Overlay est facultative. Sa valeur par défaut est false.

Le paramètre ShowBlanksAs fournit le paramètre "Hide and empty cells". La valeur par défaut est: gap. Dans l'application Excel "cellule vide est affiché comme": "espace". Les valeurs suivantes sont des valeurs facultatives pour ce paramètre:

Paramètre Explication
gap espace
span Connecter des points de données avec des lignes droites
zero zvaleur zéro

Définissez la légende du graphique pour toutes les séries de données avec la propriété Legend. Cette propriété est facultative.

Définissez la taille des bulles dans toutes les séries de données pour le graphique à bulles ou le graphique à bulles 3D par la propriété BubbleSizes. La propriété BubbleSizes est facultative. La largeur par défaut est 100 et la valeur doit être supérieure à 0 et inférieure ou égale à 300.

Définissez la taille du trou du beignet dans toutes les séries de données pour le graphique en beignet par la propriété HoleSize. La propriété HoleSize est facultative. La largeur par défaut est 75 et la valeur doit être supérieure à 0 et inférieure ou égale à 90.

Spécifie que chaque marqueur de données de la série a une couleur différente par VaryColors. La valeur par défaut est true.

Le paramètre Format fournit des paramètres pour des paramètres tels que le décalage de diagramme, l'échelle, les paramètres de format et les propriétés d'impression, ainsi que ceux utilisés dans la fonction AddPicture.

Définissez les propriétés de la zone de tracé du graphique à l'aide du champ PlotArea de type ChartPlotArea. Les propriétés configurables sont:

Paramètre Type Défaut Explication
SecondPlotValues int 0 Spécifie les valeurs dans le deuxième tracé pour les graphiques PieOfPie et BarOfPie.
ShowBubbleSize bool false Spécifie que la taille de la bulle doit apparaître dans une étiquette de données.
ShowCatName bool true Indique que le nom de la catégorie doit être affiché dans l'étiquette de données. La propriété ShowCatName est facultative.
ShowDataTable bool false Utilisé pour ajouter un tableau de données sous le graphique, en fonction du type de graphique, disponible uniquement pour les graphiques de type zone, barre, colonne et ligne.
ShowDataTableKeys bool false Utilisé pour ajouter une clé de légende dans une table de données. Fonctionne uniquement si l'option ShowDataTable est activée. La propriété ShowDataTableKeys est facultative.
ShowLeaderLines bool false Spécifie que les lignes de repère doivent être affichées pour les étiquettes de données. La propriété ShowLeaderLines est facultative.
ShowPercent bool false Indique que le pourcentage doit être indiqué dans une étiquette de données.
ShowSerName bool false Indique que le nom de la série doit apparaître dans une étiquette de données.
ShowVal bool false Indique que la valeur doit apparaître dans une étiquette de données.
Fill Fill N/A Définir la couleur de remplissage du graphique.
UpBars ChartUpDownBar N/A Spécifie le format pour les barres montantes du graphique des actions. La propriété UpBars est facultative.
DownBars ChartUpDownBar N/A Spécifie le format pour les barres baissières du graphique boursier. La propriété DownBars est optionnelle.
NumFmt ChartNumFmt N/A Spécifie cela s'il est lié à la source et définit un code de format numérique personnalisé pour les étiquettes de données. La propriété NumFmt est facultative. Le code de format par défaut est General.

Définissez les options de l'axe horizontal et vertical principal par XAxis et YAxis.

Les propriétés de XAxis qui peuvent être définies sont:

Paramètre Type Défaut Explication
None bool false Désactiver les axes.
DropLines bool false Spécifie les lignes de séparation pour les graphiques en aires et en lignes 2D et 3D. Ces lignes verticales relient les points de données à l'axe horizontal (axe des catégories). Elles sont souvent utilisées dans les graphiques en aires ou en lignes pour faciliter la visualisation de la catégorie exacte de chaque point. La propriété DropLines est facultative.
HighLowLines bool false Spécifie les lignes hautes et basses du graphique linéaire 2D. Ces lignes sont affichées par défaut sur les graphiques boursiers. Elles s'étendent de la valeur la plus élevée à la valeur la plus basse de chaque catégorie. La propriété HighLowLines est facultative.
MajorGridLines bool false Spécifie les lignes de grille principales.
MinorGridLines bool false Spécifie les lignes de grille mineures.
TickLabelSkip int 1 Spécifie le nombre d'étiquettes de graduation à ignorer entre les étiquettes dessinées. La propriété TickLabelSkip est facultative. La valeur par défaut est auto.
ReverseOrder bool false Spécifie que les catégories ou valeurs dans l'ordre inverse (orientation du graphique). La propriété ReverseOrder est facultative.
Maximum *float64 0 Indique que le maximum fixé, 0 est auto. La propriété maximum est facultative.
Minimum *float64 0 Spécifie que le minimum fixé, 0 est auto. La propriété minimum est facultative. La valeur par défaut est auto.
Alignment Alignment N/A Spécifie l'alignement des axes horizontaux et verticaux. Les propriétés de police qui peuvent être définies sont: TextRotation et Vertical
Font Font N/A Spécifie que la police de l'axe horizontal.
NumFmt ChartNumFmt N/A Spécifie que s'il est lié à la source et définit le code de format de nombre personnalisé pour l'axe.
Title []RichTextRun N/A Spécifie que le titre de l'axe horizontal principal et le graphique de redimensionnement.

Les propriétés de YAxis qui peuvent être définies sont:

Paramètre Type Défaut Explication
None bool false Désactiver les axes.
MajorGridLines bool false Spécifie les lignes de grille principales.
MinorGridLines bool false Spécifie les lignes de grille mineures.
MajorUnit float64 0 Spécifie la distance entre les graduations principales. Doit contenir un nombre à virgule flottante positif. La propriété MajorUnit est facultative. La valeur par défaut est auto.
ReverseOrder bool false Spécifie que les catégories ou valeurs dans l'ordre inverse (orientation du graphique). La propriété ReverseOrder est facultative.
Maximum *float64 0 Indique que le maximum fixé, 0 est auto. La propriété maximum est facultative.
Minimum *float64 0 Spécifie que le minimum fixé, 0 est auto. La propriété minimum est facultative. La valeur par défaut est auto.
Alignment Alignment N/A Spécifie l'alignement des axes horizontaux et verticaux. Les propriétés de police qui peuvent être définies sont: TextRotation et Vertical
Font Font N/A Spécifie que la police de l'axe vertical.
LogBase float64 N/A Spécifie le numéro de base de l'échelle logarithmique de l'axe vertical.
NumFmt ChartNumFmt N/A Spécifie que s'il est lié à la source et définit le code de format de nombre personnalisé pour l'axe.
Title []RichTextRun N/A Spécifie que le titre de l'axe vertical principal et le graphique de redimensionnement.

La valeur de TextRotation peut être définie de -90 à 90.

Les valeurs de Vertical qui peuvent être définies sont: horz, vert, vert270, wordArtVert, eaVert, mongolianVert et wordArtVertRtl.

Définissez la taille du graphique par la propriété Dimension. La propriété dimension est facultative. Les propriétés qui peuvent être définies sont:

Paramètre Type Défaut Explication
Height uint 260 Hauteur
Width uint 480 Largeur

Le paramètre combo spécifie la création d'un graphique qui combine deux ou plusieurs types de graphiques dans un seul graphique. Par exemple, créez un graphique à colonnes groupées avec des données 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", "Feuil1"); err != nil {
        fmt.Println(err)
        return
    }
    for idx, row := range [][]interface{}{
        {nil, "Apple", "Orange", "Pear"},
        {"Small", 2, 3, 3},
        {"Normal", 5, 2, 4},
        {"Large", 6, 7, 8},
    } {
        cell, err := excelize.CoordinatesToCellName(1, idx+1)
        if err != nil {
            fmt.Println(err)
            return
        }
        if err := f.SetSheetRow("Feuil1", cell, &row); err != nil {
            fmt.Println(err)
            return
        }
    }
    enable, disable := true, false
    if err := f.AddChart("Feuil1", "E1", &excelize.Chart{
        Type: excelize.Col,
        Series: []excelize.ChartSeries{
            {
                Name:       "Feuil1!$A$2",
                Categories: "Feuil1!$B$1:$D$1",
                Values:     "Feuil1!$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: "2D tableau à colonnes groupées - graphique en ligne",
                },
            },
        },
        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:       "Feuil1!$A$4",
                Categories: "Feuil1!$B$1:$D$1",
                Values:     "Feuil1!$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
    }
    // Enregistrer le classeur
    if err := f.SaveAs("Classeur1.xlsx"); err != nil {
        fmt.Println(err)
    }
}

Créer une feuille de graphique

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

AddChartSheet fournit la méthode pour créer une feuille de graphique en fonction d'un ensemble de formats de graphique donné (tels que l'offset, l'échelle, le paramètre de rapport hauteur / largeur et les paramètres d'impression) et d'un ensemble de propriétés. Dans Excel, une feuille de graphique est une feuille de calcul qui contient uniquement un graphique.

Supprimer le graphique

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

DeleteChart fournit une fonction pour supprimer le graphique dans XLSX par feuille de calcul et nom de cellule donnés.

results matching ""

    No results matching ""