Création et personnalisation des graphiques

Scénarios d’utilisation possibles

Un graphique est une présentation visuelle des informations. Aspose.Cells permet aux développeurs de visualiser des informations dans des graphiques tout comme le fait Microsoft Excel. Présenter des informations dans des graphiques est toujours utile pour les décideurs afin de prendre des décisions rapides et opportunes. Il est plus facile de voir rapidement des comparaisons, des motifs et des tendances dans les données avec des graphiques plutôt que des chiffres bruts. La création de graphiques à l’exécution, basée sur les données d’une feuille de calcul, est l’une des fonctionnalités utiles d’Aspose.Cells. Aspose.Cells prend en charge la création de graphiques standard et personnalisés. Ci-dessous, nous montrerons quelques exemples avec des fichiers d’exemple sur la manière de créer certains types de graphiques MS-Excel courants à l’aide de l’API Aspose.Cells.

Diagramme en pyramide

Lorsque le code d’exemple est exécuté, un graphique en pyramide est ajouté à la feuille de calcul. Veuillez consulter le fichier Excel de sortie du code d’exemple suivant.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

Aspose::Cells::Startup();

// Output directory path
U16String outDir(u"..\\Data\\02_OutputDirectory\\");

// Path of output excel file
U16String outputChartTypePyramid = outDir + u"outputChartTypePyramid.xlsx";

// Create a new workbook
Workbook workbook;

// Get first worksheet which is created by default
Worksheet worksheet = workbook.GetWorksheets().Get(0);

// Adding sample values to cells
worksheet.GetCells().Get(u"A1").PutValue(50);
worksheet.GetCells().Get(u"A2").PutValue(100);
worksheet.GetCells().Get(u"A3").PutValue(150);
worksheet.GetCells().Get(u"B1").PutValue(4);
worksheet.GetCells().Get(u"B2").PutValue(20);
worksheet.GetCells().Get(u"B3").PutValue(50);

// Adding a chart to the worksheet
int chartIndex = worksheet.GetCharts().Add(Aspose::Cells::Charts::ChartType::Pyramid, 5, 0, 20, 8);

// Accessing the instance of the newly added chart
Chart chart = worksheet.GetCharts().Get(chartIndex);

// Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3"
chart.GetNSeries().Add(u"A1:B3", true);

// Saving the Excel file
workbook.Save(outputChartTypePyramid);

Aspose::Cells::Cleanup();

Diagramme linéaire

Dans l’exemple ci-dessus, en modifiant simplement ChartType en ChartType::Line crée un graphique en courbes. Le code source complet est fourni ci-dessous. Lorsque le code est exécuté, un graphique en courbes est ajouté à la feuille de calcul. Veuillez consulter le fichier Excel de sortie du code d’exemple suivant.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

Aspose::Cells::Startup();

// Output directory path
U16String outDir(u"..\\Data\\02_OutputDirectory\\");

// Path of output excel file
U16String outputChartTypeLine = testPath + u"outputChartTypeLine.xlsx";

// Create a new workbook
Workbook workbook;

// Get first worksheet which is created by default
Worksheet worksheet = workbook.GetWorksheets().Get(0);

// Adding sample values to cells
worksheet.GetCells().Get(u"A1").PutValue(50);
worksheet.GetCells().Get(u"A2").PutValue(100);
worksheet.GetCells().Get(u"A3").PutValue(150);
worksheet.GetCells().Get(u"B1").PutValue(4);
worksheet.GetCells().Get(u"B2").PutValue(20);
worksheet.GetCells().Get(u"B3").PutValue(50);

// Adding a chart to the worksheet
int chartIndex = worksheet.GetCharts().Add(Aspose::Cells::Charts::ChartType::Line, 5, 0, 20, 8);

// Accessing the instance of the newly added chart
Chart chart = worksheet.GetCharts().Get(chartIndex);

// Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3"
chart.GetNSeries().Add(u"A1:B3", true);

// Saving the Excel file
workbook.Save(outputChartTypeLine);

Aspose::Cells::Cleanup();

Diagramme en bulles

Afin de créer un graphique en bulles, ChartType doit être défini sur ChartType_Bubble et quelques propriétés supplémentaires telles que SetBubbleSizes & SetXValues doivent être définies en conséquence. Après l’exécution du code suivant, un graphique en bulles est ajouté à la feuille de calcul. Veuillez consulter le fichier Excel de sortie du code d’exemple suivant.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

Aspose::Cells::Startup();

// Output directory path
U16String outDir(u"..\\Data\\02_OutputDirectory\\");

// Path of output excel file
U16String outputChartTypeBubble = outDir + u"outputChartTypeBubble.xlsx";

// Create a new workbook
Workbook workbook;

// Get first worksheet which is created by default
Worksheet worksheet = workbook.GetWorksheets().Get(0);

// Fill in data for chart's series
// Y Values
worksheet.GetCells().Get(0, 0).PutValue(u"Y Values");
worksheet.GetCells().Get(0, 1).PutValue(2);
worksheet.GetCells().Get(0, 2).PutValue(4);
worksheet.GetCells().Get(0, 3).PutValue(6);
// Bubble Size
worksheet.GetCells().Get(1, 0).PutValue(u"Bubble Size");
worksheet.GetCells().Get(1, 1).PutValue(2);
worksheet.GetCells().Get(1, 2).PutValue(3);
worksheet.GetCells().Get(1, 3).PutValue(1);
// X Values
worksheet.GetCells().Get(2, 0).PutValue(u"X Values");
worksheet.GetCells().Get(2, 1).PutValue(1);
worksheet.GetCells().Get(2, 2).PutValue(2);
worksheet.GetCells().Get(2, 3).PutValue(3);

// Set first column width
worksheet.GetCells().SetColumnWidth(0, 12);

// Adding a chart to the worksheet
int chartIndex = worksheet.GetCharts().Add(Aspose::Cells::Charts::ChartType::Bubble, 5, 0, 20, 8);

// Accessing the instance of the newly added chart
Chart chart = worksheet.GetCharts().Get(chartIndex);

// Adding SeriesCollection (chart data source) to the chart ranging from B1 to D1
chart.GetNSeries().Add(u"B1:D1", true);

// Set bubble sizes
chart.GetNSeries().Get(0).SetBubbleSizes(u"B2:D2");

// Set X axis values
chart.GetNSeries().Get(0).SetXValues(u"B3:D3");

// Set Y axis values
chart.GetNSeries().Get(0).SetValues(u"B1:D1");

// Saving the Excel file
workbook.Save(outputChartTypeBubble);

Aspose::Cells::Cleanup();

Création de graphiques personnalisés

Jusqu’à présent, lorsque nous avons discuté des graphiques, nous avons examiné des graphiques standards qui ont leurs propres paramètres de formatage standard. Nous définissons simplement 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 les API Aspose.Cells prennent également en charge la création de graphiques personnalisés qui permet aux développeurs de créer des graphiques avec leurs propres paramètres de formatage. Les développeurs peuvent créer des graphiques personnalisés à l’exécution à l’aide d’Aspose.Cells.

Un graphique est composé d’une série de données. 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.

L’exemple de code ci-dessous démontre comment créer des graphiques personnalisés. Dans cet exemple, nous allons utiliser un graphique en colonnes pour la première série de données et un graphique en ligne pour la deuxième série. Le résultat est que nous ajoutons un graphique en colonnes, combiné avec un graphique en ligne, à la feuille de calcul. Veuillez consulter le fichier Excel de sortie du code d’exemple suivant.

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-C

Aspose::Cells::Startup();

// Output directory path
U16String outDir(u"..\\Data\\02_OutputDirectory\\");

// Path of output excel file
U16String outputChartTypeCustom = outDir + u"outputChartTypeCustom.xlsx";

// Create a new workbook
Workbook workbook;

// Get first worksheet which is created by default
Worksheet worksheet = workbook.GetWorksheets().Get(0);

// Adding sample values to cells
worksheet.GetCells().Get(u"A1").PutValue(50);
worksheet.GetCells().Get(u"A2").PutValue(100);
worksheet.GetCells().Get(u"A3").PutValue(150);
worksheet.GetCells().Get(u"A4").PutValue(110);
worksheet.GetCells().Get(u"B1").PutValue(260);
worksheet.GetCells().Get(u"B2").PutValue(12);
worksheet.GetCells().Get(u"B3").PutValue(50);
worksheet.GetCells().Get(u"B4").PutValue(100);

// Adding a chart to the worksheet
int chartIndex = worksheet.GetCharts().Add(Aspose::Cells::Charts::ChartType::Column, 5, 0, 20, 8);

// Accessing the instance of the newly added chart
Chart chart = worksheet.GetCharts().Get(chartIndex);

// Adding SeriesCollection (chart data source) to the chart ranging from A1 to B4
chart.GetNSeries().Add(u"A1:B4", true);

// Setting the chart type of 2nd NSeries to display as line chart
chart.GetNSeries().Get(1).SetType(Aspose::Cells::Charts::ChartType::Line);

// Saving the Excel file
workbook.Save(outputChartTypeCustom);

Aspose::Cells::Cleanup();