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 :

1. 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.
2. Ajoutez un graphique à la feuille de calcul en appelant leCollection de graphiques la collectionajouter, encapsulée dans leFeuille de travailobjet.
3. Spécifiez le type de graphique avec leType de graphiqueénumération. Par exemple, l’exemple utilise leChartType.PYRAMIDvaleur comme type de graphique.
4. Accédez au nouveauGraphique objet duCollection de graphiquescollection en passant son index.
5. 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”).

Lorsque vous attribuez une plage de cellules comme source de données, vous ne pouvez définir la plage que du coin supérieur gauche au coin inférieur droit. Par exemple, « A1:C3 » est valide tandis que « C3:A1 » n’est pas valide.

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).

Actuellement, la version Aspose.Cells ne prend en charge que les graphiques personnalisés combinant des graphiques à secteurs, en courbes, en colonnes et en colonnes, mais davantage de graphiques seront pris en charge dans les versions futures. Pour une liste complète des cartes standard prises en charge par Aspose.Cells, lisez leTypes de graphiques article.

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

Pour voir une liste des types de graphiques pris en charge, lisez leTypes de graphiques article.