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 :

Ce qu’il faut 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.

Objets graphiques

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éertracer des objets, qui agissent comme les 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 de graphique dans la feuille de calcul.
• ChartDataTable, une table de données de graphique.
• CadreGraphique, l’objet cadre d’un graphique.
• Point de graphique, un seul point d’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, Point de graphique, Ligne de tendance, etc.
• RemplirFormat, format de remplissage pour une forme.
• Étage, le plancher d’un graphique 3D.
• Légende, la légende du graphique.
• La ligne, la ligne du graphique.
• SérieCollection , une collection deSérieobjets.
• Série, représente une seule série de données dans un graphique.
• TickLabels, 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.
• TrendlineCollection, une collection de tous les objets Trendline pour la série de données spécifiée.
• Des murs, les parois d’un graphique 3D.

Utilisation d’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 laCollection de graphiques le recueil. Chaque élément de laCollection de graphiques la collection représente unGraphique objet. UNEGraphiqueL’objet encapsule tous les objets graphiques nécessaires pour personnaliser l’apparence du graphique. La section suivante montre comment utiliser quelques objets graphiques de base pour créer un graphique simple.

Création d’un graphique simple

Il est possible de créer de nombreux types de graphiques différents avec Aspose.Cells. Tous les graphiques standard 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 l’histogramme groupé
Colonneempilée	Représente un graphique à colonnes empilées
Colonne100PercentStacked	Représente un graphique à colonnes empilées à 100 %
Colonne3DCluster	Représente l’histogramme groupé 3D
Colonne3DSempilé	Représente un graphique à colonnes empilées 3D
Column3D100PercentStacked	Représente un graphique à colonnes empilées 3D à 100 %
Colonne3D	Représente l’histogramme 3D
Bar	Représente un graphique à barres groupées
Barreempilée	Représente un graphique à barres empilées
Barre100PercentStacked	Représente un graphique à barres empilées à 100 %
Bar3DCluster	Représente un graphique à barres groupées 3D
Bar3DStacked	Représente un graphique à barres empilées 3D
Barre3D100Pourcentage empilé	Représente un graphique à barres empilées 3D à 100 %
La ligne	Représente le graphique en courbes
Ligneempilée	Représente un graphique en courbes empilées
Line100PercentStacked	Représente un graphique linéaire empilé à 100 %
LineWithDataMarkers	Représente le graphique linéaire avec des marqueurs de données
LineStackedWithDataMarkers	Représente un graphique en courbes empilées avec des marqueurs de données
Line100PercentStackedWithDataMarkers	Représente un graphique linéaire empilé à 100 % avec des marqueurs de données
Ligne3D	Représente un graphique en courbes 3D
Tarte	Représente le graphique à secteurs
Pie3D	Représente un graphique à secteurs 3D
TarteTarte	Représente Pie of Pie Chart
TarteExplosée	Représente un graphique à secteurs éclaté
Tarte3DÉclaté	Représente un graphique à secteurs éclaté en 3D
PieBar	Représente la barre du graphique à secteurs
Dispersion	Représente le nuage de points
ScatterConnectedByCurvesWithDataMarker	Représente le diagramme de dispersion relié par des courbes, avec des marqueurs de données
ScatterConnectedByCurvesWithoutDataMarker	Représente le diagramme de dispersion relié par des courbes, sans marqueurs de données
ScatterConnectedByLinesWithDataMarker	Représente le diagramme de dispersion relié par des lignes, avec des marqueurs de données
ScatterConnectedByLinesWithoutDataMarker	Représente le diagramme de dispersion connecté par des lignes, sans marqueurs de données
Surface	Représente le graphique en aires
Zoneempilée	Représente un graphique en aires empilées
Area100PercentStacked	Représente un graphique en aires empilées à 100 %
Zone3D	Représente le graphique en aires 3D
Area3DStacked	Représente un graphique en aires empilées 3D
Area3D100PercentStacked	Représente un graphique en aires empilées 3D à 100 %
Donut	Représente le graphique en anneau
BeignetÉclaté	Représente le graphique en anneau éclaté
Radar	Représente le graphique radar
RadarAvecMarqueursDeDonnées	Représente le graphique radar avec des marqueurs de données
Radar Rempli	Représente le graphique radar rempli
Surface3D	Représente le graphique de surface 3D
SurfaceWireframe3D	Représente le graphique de surface filaire 3D
Contour de surface	Représente le graphique de contour
SurfaceContourWireframe	Représente le graphique de contour filaire
Bulle	Représente le graphique à bulles
Bulle3D	Représente le graphique à bulles 3D
Cylindre	Représente le diagramme de cylindre
CylindreEmpilé	Représente un diagramme de cylindres empilés
Cylindre100PercentStacked	Représente un tableau de cylindres empilés à 100 %
CylindriqueBar	Représente un graphique à barres cylindriques.
CylindriqueBarEmpilés	Représente un graphique à barres cylindriques empilés
CylindriqueBar100PercentStacked	Représente un graphique à barres cylindriques empilés à 100 %
CylindriqueColonne3D	Représente l’histogramme cylindrique 3D
Cône	Représente le graphique en cône
ConeStacked	Représente un graphique en cône empilé
Cône100PercentStacked	Représente un graphique en cône empilé à 100 %
Barre conique	Représente un graphique à barres coniques
ConiqueBarEmpilés	Représente un graphique à barres coniques empilées
ConicalBar100PercentStacked	Représente un graphique à barres coniques empilées à 100 %
ConicalColumn3D	Représente l’histogramme conique 3D
Pyramide	Représente un graphique pyramidal
PyramideEmpilés	Représente un graphique pyramidal empilé
Pyramid100PercentStacked	Représente un graphique pyramidal empilé à 100 %
PyramidBar	Représente le graphique à barres pyramidal
PyramideBarEmpilés	Représente un graphique à barres pyramidal empilé
PyramidBar100PercentStacked	Représente un graphique à barres pyramidal empilé à 100 %
PyramideColonne3D	Représente l’histogramme 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 objetssetValueméthode. Il sera utilisé comme source de données pour le graphique.
2. Ajoutez un graphique à la feuille de calcul en appelant leCollection de graphiques de la collectionajouter, encapsulée dans la méthodeFeuille 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éder au nouveauGraphique objet de laCollection 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 de 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 affectez une plage de cellules en tant que source de données, vous ne pouvez définir la plage que du haut à gauche au bas à droite. Par exemple, “A1:C3” est valide alors que “C3:A1” n’est pas valide.

Ces étapes générales vous permettent de créer n’importe quel 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.

Diagramme pyramidal avec sa source de données

Pour créer un graphique à bulles, leType de graphiquedoit être réglé surType de graphique. BUBBLEet quelques propriétés supplémentaires telles que BubbleSizes, Values & 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 marqueur de données

Pour créer une ligne avec un graphique de marqueurs de données, leType de graphiquedoit être réglé surType de graphique.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 XValues doivent être définies en conséquence. Lors de l’exécution du code suivant, une ligne avec un graphique de marqueur 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 qui ont leurs paramètres de mise en forme 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 lors de l’exécution en utilisant Aspose.Cells simple 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érie objet 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, Aspose.Cells ne prend en charge que les graphiques personnalisés qui combinent des graphiques à secteurs, linéaires, à colonnes et à 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 graphique à colonnes, 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.