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 |
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. |
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. |
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 |
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
.
Le titre du graphique est défini en sélectionnant le paramètre Name
de l'objet Title
et le titre sera affiché au-dessus du graphique. Le paramètre Name
prend en charge l'utilisation de représentations de formules, telles que Sheet1!$A$1
, si vous ne spécifiez pas de titre d'icône, la valeur par défaut est null.
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 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 la position de la zone de tracé de graphique par plotarea. Les propriétés qui peuvent être définies 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 |
false |
Nom de catégorie |
ShowLeaderLines | bool |
false |
Indique que le nom de la catégorie doit apparaître dans l'étiquette de données. |
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. |
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. |
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.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.