Personnalisation des graphiques
Création de graphiques
Il est possible d’ajouter une variété de graphiques aux feuilles de calcul avec Aspose.Cells. Aspose.Cells fournit de nombreux objets graphiques flexibles. Cette rubrique traite des objets graphiques Aspose.Cells.
Créer simplement un graphique
Il est simple de créer un graphique avec Aspose.Cells avec les exemples de codes suivants :
Choses à savoir pour créer un graphique
Avant de créer des graphiques, il est important de comprendre certains concepts de base utiles lors de la création de graphiques à l’aide de Aspose.Cells.
Graphiquer des objets
Aspose.Cells fournit un ensemble spécial de classes utilisées pour créer toutes sortes de graphiques. Ces classes sont utilisées pour créer des objets graphiques*, qui servent de blocs de construction du graphique. Les objets graphiques sont répertoriés ci-dessous :
- Axe, l’axe d’un graphique.
- Graphique, un seul graphique Excel.
- ZoneGraphique, la zone graphique de la feuille de calcul.
- GraphiqueDonnéesTable, un tableau de données graphiques.
- Cadre graphique, l’objet frame dans un graphique.
- ChartPoint, un seul point dans une série dans un graphique.
- ChartPointCollection, une collection qui contient tous les points d’une série.
- Collection de graphiques une collection deGraphiqueobjets.
- DataLabels, DataLabels pour le spécifiéSérie, ChartPoint, Ligne de tendance, etc.
- RemplirFormat, remplissez le format d’une forme.
- Sol, le sol d’un graphique 3D.
- Légende, la légende du graphique.
- Doubler, la ligne du graphique.
- SérieCollection une collection deSérieobjets.
- Série, représente une seule série de données dans un graphique.
- Étiquettes de tiques, les étiquettes de graduation associées aux graduations sur un axe du graphique.
- Titre, le titre d’un graphique ou d’un axe.
- Ligne de tendance, une ligne de tendance dans un graphique.
- Collection de lignes de tendance, une collection de tous les objets Trendline pour la série de données spécifiée.
- Des murs, les murs d’un graphique 3D.
Utiliser des objets graphiques
Comme mentionné ci-dessus, tous les objets graphiques sont des instances de leurs classes respectives et fournissent des propriétés et des méthodes spécifiques pour effectuer des tâches spécifiques. Utilisez des objets graphiques pour créer des graphiques.
Ajoutez n’importe quel type de graphique à une feuille de calcul à l’aide de l’outilCollection de graphiques collection. Chaque élément duCollection de graphiques la collection représente unGraphique objet. UNGraphiqueL’objet encapsule tous les objets graphiques requis pour personnaliser l’apparence du graphique. La section suivante montre comment utiliser quelques objets graphiques de base pour créer un graphique simple.
Créer un graphique simple
Il est possible de créer de nombreux types de graphiques différents avec Aspose.Cells. Tous les graphiques standards pris en charge par Aspose.Cells sont prédéfinis dans une énumération nomméeType de graphique. Les types de graphiques prédéfinis sont :
Types de graphiques | Description |
---|---|
Colonne | Représente le graphique à colonnes groupées |
ColonneStacked | Représente un graphique à colonnes empilées |
Colonne100PercentStacked | Représente un graphique à colonnes empilées à 100 % |
Colonne3DCclustérisée | Représente un histogramme groupé 3D |
Colonne3DStacked | Représente un graphique à colonnes empilées en 3D |
Colonne3D100PourcentageStacked | Représente un graphique à colonnes 3D empilé à 100 % |
Colonne3D | Représente un histogramme 3D |
Bar | Représente un graphique à barres groupées |
BarStacked | Représente un graphique à barres empilées |
Bar100PourcentEmpilé | Représente un graphique à barres empilées à 100 % |
Bar3DCluster | Représente un graphique à barres groupées 3D |
Bar3DSempilé | Représente un graphique à barres empilées 3D |
Bar3D100PourcentageEmpilé | Représente un graphique à barres empilées 3D à 100 % |
Doubler | Représente un graphique linéaire |
LigneStacked | Représente un graphique en courbes empilées |
Ligne100PercentStacked | Représente un graphique en courbes empilées à 100 % |
LigneAvecDataMarkers | Représente un graphique linéaire avec des marqueurs de données |
LineStackedWithDataMarkers | Représente un graphique en courbes empilées avec des marqueurs de données |
Ligne100PercentStackedWithDataMarkers | Représente un graphique linéaire empilé à 100 % avec des marqueurs de données |
Ligne3D | Représente un graphique linéaire 3D |
Tarte | Représente un diagramme circulaire |
Tarte3D | Représente un diagramme circulaire 3D |
TarteTarte | Représente un diagramme circulaire |
TarteExplodé | Représente un diagramme circulaire éclaté |
Tarte3DExplodé | Représente un diagramme circulaire éclaté en 3D |
TarteBar | Représente la barre du graphique à secteurs |
Dispersion | Représente le graphique à nuages de points |
DispersionConnectéeByCurvesWithDataMarker | Représente le graphique à nuages de points relié par des courbes, avec des marqueurs de données |
DispersionConnectedByCurvesWithoutDataMarker | Représente le graphique à nuages de points connecté par des courbes, sans marqueurs de données |
DispersionConnectedByLinesWithDataMarker | Représente le graphique à nuages de points relié par des lignes, avec des marqueurs de données |
DispersionConnectedByLinesWithoutDataMarker | Représente le graphique à nuages de points relié par des lignes, sans marqueurs de données |
Zone | Représente un graphique en aires |
ZoneStacked | Représente un graphique à aires empilées |
Zone100PourcentageStacked | Représente un graphique à zones empilées à 100 % |
Zone3D | Représente un graphique en aires 3D |
Area3DSacked | Représente un graphique à zones empilées 3D |
Surface3D100PourcentageStacked | Représente un graphique 3D à zones empilées à 100 % |
Donut | Représente le graphique en beignet |
BeignetExplosé | Représente un graphique en anneau éclaté |
Radar | Représente la carte radar |
RadarAvecDataMarkers | Représente le graphique radar avec des marqueurs de données |
RadarRempli | Représente un graphique radar rempli |
Surface3D | Représente un graphique de surface 3D |
SurfaceFilaire3D | Représente le graphique de surface 3D filaire |
Contour de surface | Représente le graphique de contour |
SurfaceContourFilaire | Représente un graphique de contour filaire |
Bulle | Représente un graphique à bulles |
Bulle3D | Représente un graphique à bulles 3D |
Cylindre | Représente le diagramme de cylindre |
CylindreStacked | Représente un graphique de cylindres empilés |
Cylindre100PourcentEmpilé | Représente un tableau de cylindres empilés à 100 % |
Barre Cylindrique | Représente un graphique à barres cylindriques. |
CylindriqueBarEmpilé | Représente un graphique à barres cylindriques empilées |
CylindriqueBar100PourcentEmpilé | Représente un graphique à barres cylindriques empilées à 100 % |
CylindriqueColonne3D | Représente un graphique à colonnes cylindriques 3D |
Cône | Représente un graphique conique |
CôneEmpilé | Représente un graphique à cônes empilés |
Cône100PourcentEmpilé | Représente un graphique à cônes empilés à 100 % |
Barre conique | Représente un graphique à barres coniques |
ConiqueBarEmpilé | Représente un graphique à barres coniques empilées |
ConiqueBar100PourcentEmpilé | Représente un graphique à barres coniques empilées à 100 % |
ConiqueColonne3D | Représente un graphique à colonnes coniques 3D |
Pyramide | Représente un graphique pyramidal |
PyramideEmpilé | Représente un graphique pyramidal empilé |
Pyramide100PourcentEmpilé | Représente un graphique pyramidal empilé à 100 % |
PyramideBar | Représente le graphique à barres pyramidales |
PyramideBarEmpilé | Représente un graphique à barres pyramidales empilées |
PyramideBar100PourcentEmpilé | Représente un graphique à barres pyramidales empilées à 100 % |
PyramideColonne3D | Représente un diagramme à colonnes pyramidal 3D |
Pour créer un graphique en utilisant Aspose.Cells : |
- Ajoutez des données aux cellules de la feuille de calcul avec leCell objetsdéfinirValeurméthode. Ceci sera utilisé comme source de données pour le graphique.
- Ajoutez un graphique à la feuille de calcul en appelant leCollection de graphiques la collectionajouter, encapsulée dans leFeuille de travailobjet.
- Spécifiez le type de graphique avec leType de graphiqueénumération. Par exemple, l’exemple utilise leChartType.PYRAMIDvaleur comme type de graphique.
- Accédez au nouveauGraphique objet duCollection de graphiquescollection en passant son index.
- Utilisez n’importe lequel des objets graphiques encapsulés dans leGraphiqueobjet pour gérer le graphique. L’exemple ci-dessous utilise leSérieCollectionobjet graphique pour spécifier la source de données du graphique.
Lors de l’ajout de données source au graphique, la source de données peut être une plage de cellules (telle que “A1:C3”), ou une séquence de cellules non contiguës (telle que “A1, A3, A5”), ou une séquence de valeurs (telles que “1,2,3”).
Ces étapes générales vous permettent de créer tout type de graphique. Utilisez différents objets graphiques pour créer différents graphiques.
Lorsque l’exemple de code est exécuté, un graphique pyramidal est ajouté à la feuille de calcul comme indiqué ci-dessous.
Graphique pyramidal avec sa source de données
Pour créer un graphique à bulles, leType de graphiquedoit être réglé surChartType.BUBBLEet quelques propriétés supplémentaires telles que BubbleSizes, Values et XValues doivent être définies en conséquence. Lors de l’exécution du code suivant, un graphique à bulles est ajouté à la feuille de calcul comme indiqué ci-dessous.
Graphique à bulles avec sa source de données
Ligne avec graphique de marqueurs de données
Pour créer une ligne avec un graphique de marqueurs de données, leType de graphiquedoit être réglé surChartType.LINE_WITH_DATA_MARKERS et quelques propriétés supplémentaires telles que la zone d’arrière-plan, les marqueurs de série, les valeurs et les valeurs XV doivent être définies en conséquence. Lors de l’exécution du code suivant, une ligne avec un graphique de marqueurs de données est ajoutée à la feuille de calcul.
Création de graphiques personnalisés
Jusqu’à présent, lorsque nous avons discuté des graphiques, nous avons examiné les graphiques standard dotés de leurs paramètres de formatage standard. Nous définissons uniquement la source de données, définissons quelques propriétés et le graphique est créé avec ses paramètres de format par défaut. Mais Aspose.Cells prend également en charge la création de graphiques personnalisés qui permettent aux développeurs de créer des graphiques avec leurs propres paramètres de format.
Création de graphiques personnalisés
Les développeurs peuvent créer des graphiques personnalisés au moment de l’exécution en utilisant le simple Aspose.Cells API.
Un graphique est composé d’une série de données. Chaque série de données dans Aspose.Cells est représentée par unSérieobjet alors que leSérieCollection l’objet sert de collection deSérieobjets. Lors de la création d’un graphique personnalisé, les développeurs ont la liberté d’utiliser différents types de graphiques pour différentes séries de données (collectées dans unSérieCollectionobjet).
L’exemple de code ci-dessous montre comment créer des graphiques personnalisés. Dans cet exemple, nous allons utiliser un histogramme pour la première série de données et un graphique linéaire pour la deuxième série. Le résultat est que nous ajoutons un histogramme, combiné à un graphique linéaire, à la feuille de calcul.
Graphique personnalisé combinant des graphiques à colonnes et à courbes
Exemple de programmation