Formatage du graphique
Réglage de l’apparence du graphique
Dans les Types de graphique, nous avons brièvement présenté les types de graphiques et d’objets de graphique offerts par Aspose.Cells.
Dans cet article, nous discutons de la personnalisation de l’apparence des graphiques en définissant un certain nombre de propriétés différentes :
- Définir la zone du graphique.
- Définir les lignes du graphique.
- Appliquer des thèmes.
- Définir les titres des graphiques et des axes.
- Travailler avec les lignes de quadrillage.
- Définir les bordures des parois arrière et latérales.
Définition de la zone du graphique
Il existe différents types de zones dans un graphique et Aspose.Cells offre la flexibilité de modifier l’apparence de chaque zone. Les développeurs peuvent appliquer différents paramètres de formatage sur une zone en modifiant sa couleur avant-plan, sa couleur d’arrière-plan et son format de remplissage, etc.
Dans l’exemple ci-dessous, nous avons appliqué différents paramètres de mise en forme sur différents types de zones d’un graphique. Ces zones comprennent :
- Zone de traçage
- Zone du graphique
- Zone SeriesCollection
- La zone d’un seul point dans un SeriesCollection
Après l’exécution du code d’exemple, un histogramme à colonnes sera ajouté à la feuille de calcul comme indiqué ci-dessous :
Un histogramme à colonnes avec des zones remplies
Définition des lignes du graphique
Les développeurs peuvent également appliquer différents types de styles sur les lignes ou les repères de données du SeriesCollection comme indiqué ci-dessous dans l’exemple. L’exécution du code d’exemple ajoute un histogramme à colonnes à la feuille de calcul comme indiqué ci-dessous :
Histogramme à colonnes après application des styles de ligne
Application des thèmes Microsoft Excel 2007/2010 aux graphiques
Les développeurs peuvent appliquer différents thèmes et couleurs Microsoft Excel au SeriesCollection ou à d’autres objets graphiques comme indiqué dans l’exemple ci-dessous.
Configuration des titres des graphiques ou des axes
Vous pouvez utiliser Microsoft Excel pour définir les titres d’un graphique et de ses axes dans un environnement WYSIWYG comme indiqué ci-dessous.
Définition des titres d’un graphique et de ses axes à l’aide de Microsoft Excel
Aspose.Cells permet également aux développeurs de définir les titres d’un graphique et de ses axes à l’exécution. Tous les graphiques et leurs axes contiennent une méthode Title.setText qui peut être utilisée pour définir leurs titres comme indiqué dans l’exemple ci-dessous. Après l’exécution du code d’exemple, un histogramme à colonnes sera ajouté à la feuille de calcul comme indiqué ci-dessous :
Histogramme à colonnes après la définition des titres
Définition des principales lignes de la grille
Masquer les grandes lignes de la grille
Les développeurs peuvent contrôler la visibilité des grandes lignes de la grille en utilisant la méthode setVisible de l’objet Line. Après avoir masqué les grandes lignes de la grille, un graphique à colonnes ajouté à la feuille de calcul présente l’apparence suivante :
Un graphique à colonnes avec des grandes lignes de grille masquées
Changer les paramètres des grandes lignes de la grille
Les développeurs peuvent non seulement contrôler la visibilité des grandes lignes de la grille, mais aussi d’autres propriétés telles que sa couleur, etc. Après avoir défini la couleur des grandes lignes de la grille, un graphique à colonnes ajouté à la feuille de calcul aura l’apparence suivante :
Graphique à colonnes avec des grandes lignes de grille colorées
Définition des bordures pour les parois arrière et latérales
Depuis la sortie de Microsoft Excel 2007, les parois d’un graphique 3D ont été divisées en deux parties : paroi latérale et paroi arrière, donc nous devons utiliser deux objets Walls pour les représenter séparément et vous pouvez y accéder en utilisant Chart.getBackWall() et Chart.getSideWall().
L’exemple ci-dessous montre comment définir la bordure de la paroi latérale en utilisant différentes attributs.
Modifier la position et la taille du graphique
Parfois, vous souhaitez modifier la position ou la taille du graphique nouvellement ajouté ou existant à l’intérieur de la feuille de calcul. Aspose.Cells fournit la propriété Chart.getChartObject() pour y parvenir. Vous pouvez utiliser ses sous-propriétés pour redimensionner le graphique avec une nouvelle hauteur et largeur ou le repositionner avec de nouvelles coordonnées X et Y.
Modifier la position et la taille du graphique
Pour changer la position (coordonnées X, Y) et la taille (hauteur, largeur) du graphique, utilisez ces propriétés :
- Chart.getChartObject().get/setWidth()
- Chart.getChartObject().get/setHeight()
- Chart.getChartObject().get/setX()
- Chart.getChartObject().get/setY()
L’exemple suivant explique l’utilisation des propriétés ci-dessus. Il charge le classeur existant contenant un graphique dans sa première feuille de calcul. Ensuite, il redimensionne et repositionne le graphique et enregistre le classeur.
Avant l’exécution du code d’exemple, le fichier source ressemble à ceci :
Taille et position du graphique avant l’exécution du code d’exemple
Après l’exécution, le fichier de sortie ressemble à ceci:
Taille et position du graphique après l’exécution du code d’exemple
Manipulation des graphiques de concepteur
Il arrive que vous deviez manipuler ou modifier les graphiques dans vos fichiers de modèle de créateur. Aspose.Cells prend en charge entièrement la manipulation des graphiques du créateur avec leurs contenus et éléments. Les données, les contenus des graphiques, l’image de fond et le formatage peuvent être préservés avec précision.
Manipulation des graphiques du créateur dans les fichiers de modèle
Pour manipuler les graphiques du créateur dans un fichier de modèle, utilisez tous les appels d’API liés aux graphiques. Par exemple, utilisez la propriété Worksheet.getCharts pour obtenir la collection de graphiques existante dans le fichier de modèle.
Création d’un graphique
L’exemple suivant montre comment créer un graphique circulaire. Nous manipulerons ce graphique par la suite. La sortie suivante est générée par le code.
Le graphique circulaire d’entrée
Manipulation du graphique
L’exemple suivant montre comment manipuler le graphique existant. Dans cet exemple, nous modifions le graphique créé précédemment. La sortie suivante est générée par le code. Notez que la couleur du titre du graphique est passée du bleu au noir, et ‘Angleterre 30000’ a été modifié en ‘Royaume-Uni, 30K’.
Le graphique circulaire a été modifié
Manipulation d’un graphique linéaire dans le modèle de concepteur
Dans cet exemple, nous manipulerons un graphique linéaire. Nous ajouterons des séries de données au graphique existant et changerons leurs couleurs de ligne.
Tout d’abord, jetez un œil au graphique linéaire du créateur.
Le graphique linéaire d’entrée
Maintenant, nous manipulons le graphique linéaire (qui est contenu dans le fichier linechart.xls) en utilisant le code suivant. La sortie suivante est générée par le code.
Le graphique linéaire manipulé
Utilisation des sparklines
Microsoft Excel 2010 peut analyser les informations de plus de façons que jamais. Il permet aux utilisateurs de suivre et de mettre en évidence les tendances importantes des données avec de nouveaux outils d’analyse et de visualisation des données. Les sparklines sont des mini-graphiques que vous pouvez placer à l’intérieur des cellules afin de visualiser les données et le graphique sur la même table. Lorsque les sparklines sont utilisés correctement, l’analyse des données est plus rapide et plus directe. Ils offrent également une vue simple des informations, évitant les feuilles de calcul surchargées avec de nombreux graphiques complexes.
Aspose.Cells fournit une API pour manipuler les sparklines dans les feuilles de calcul.
Sparklines dans Microsoft Excel
Pour insérer des sparklines dans Microsoft Excel 2010 :
- Sélectionnez les cellules où vous souhaitez voir apparaître les sparklines. Pour les rendre faciles à visualiser, sélectionnez les cellules à côté des données.
- Cliquez sur Insérer dans le ruban, puis choisissez colonne dans le groupe Sparklines.
- Sélectionnez ou saisissez la plage de cellules dans la feuille de calcul qui contient les données source. Les graphiques apparaissent.
Les sparklines vous aident à voir les tendances, par exemple, ou le bilan des victoires ou des défaites pour une ligue de softball. Les sparklines peuvent même résumer toute la saison de chaque équipe de la ligue.
Sparklines en utilisant Aspose.Cells
Les développeurs peuvent créer, supprimer ou lire les sparklines (dans le fichier modèle) en utilisant l’API fournie par Aspose.Cells. En ajoutant des graphiques personnalisés pour une plage de données donnée, les développeurs ont la liberté d’ajouter différents types de petits graphiques aux zones de cellules sélectionnées.
L’exemple ci-dessous illustre la fonctionnalité des Sparklines. L’exemple montre comment :
- Ouvrir un fichier modèle simple.
- Lire les informations des sparklines pour une feuille de calcul.
- Ajouter de nouvelles sparklines pour une plage de données donnée à une zone de cellules.
- Enregistrer le fichier Excel sur le disque.
Application du format 3D au graphique
Vous pourriez avoir besoin de styles de graphique 3D pour obtenir les résultats correspondant à votre scénario. Les API Aspose.Cells fournissent l’API pertinente pour appliquer la mise en forme 3D de Microsoft Excel 2007 comme démontré dans cet article.
Réglage du format 3D au graphique
Un exemple complet est donné ci-dessous pour démontrer comment créer un graphique et lui appliquer la mise en forme 3D de Microsoft Excel 2007. Après l’exécution du code d’exemple ci-dessus, un graphique en colonnes (avec des effets 3D) sera ajouté à la feuille de calcul comme indiqué ci-dessous.
Un graphique en colonnes avec mise en forme 3D
