En savoir plus sur Xceed Words pour .NET

Cette semaine, nous verrons comment ajouter des graphiques à vos documents.

Graphiques

Lorsque vous souhaitez attirer l'attention de votre lecteur, un graphique permet d'afficher des informations et des données d'une manière plus visuelle qu'un tableau.

Création d'un graphique

Il existe actuellement 3 types de graphiques : BarChart, LineChart et Diagramme à secteurs.

// Create a new BarChart
var c1 = new BarChart();

// Create a new LineChart
var c2 = new LineChart();

// Create a new PieChart
var c3 = new PieChart();

Légende du graphique

Un ChartLegend n'est pas obligatoire, mais il peut aider le lecteur à comprendre les données affichées dans le graphique. L'ajout d'un ChartLegend se fait en appelant la fonction AddLegend sur le graphique. Les paramètres à inclure sont la position du graphique (en bas, à gauche, à droite, en haut ou en haut à droite) et si les éléments du graphique sont autorisés à chevaucher cette ChartLegend (vrai/faux).

// Add a ChartLegent
c.AddLegend( ChartLegendPosition.Left, false );

La suppression de la ChartLegend existante d'un graphique s'effectue en appelant la fonction Supprimer la légende méthode.

// Remove the ChartLegend
c.RemoveLegend();

Données graphiques

Dans un scénario réel, vous auriez très probablement une base de données à partir de laquelle vous obtiendriez des données. Dans notre exemple, nous allons créer nous-mêmes des données à l'aide d'une simple classe ChartData qui contient deux propriétés : Catégorie (chaîne) et Dépenses (double).

// Create the data.
var canada = new List()
{
  new ChartData() { Category = "Food", Expenses = 100 },
  new ChartData() { Category = "Housing", Expenses = 120 },
  new ChartData() { Category = "Transportation", Expenses = 140 },
  new ChartData() { Category = "Health Care", Expenses = 150 }
};
var usa = new List()
{
  new ChartData() { Category = "Food", Expenses = 200 },
  new ChartData() { Category = "Housing", Expenses = 150 },
  new ChartData() { Category = "Transportation", Expenses = 110 },
  new ChartData() { Category = "Health Care", Expenses = 100 }
};
var brazil = new List()
{
  new ChartData() { Category = "Food", Expenses = 125 },
  new ChartData() { Category = "Housing", Expenses = 80 },
  new ChartData() { Category = "Transportation", Expenses = 110 },
  new ChartData() { Category = "Health Care", Expenses = 60 }
};

 Ensuite, nous allons créer des séries avec les données et les ajouter au graphique en appelant sa fonction Ajouter une série méthode.

// Create and add series by binding X and Y.
var s1 = new Series( "Brazil" );
s1.Bind( brazil, "Category", "Expenses" );
c.AddSeries( s1 );

var s2 = new Series( "USA" );
s2.Bind( usa, "Category", "Expenses" );
c.AddSeries( s2 );

var s3 = new Series( "Canada" );
s3.Bind( canada, "Category", "Expenses" );
c.AddSeries( s3 );

Ajout de graphiques

Une fois que le graphique est prêt, il suffit de l'ajouter à un document en appelant l'une ou l'autre des options suivantes Insérer un graphique ou Insérer un graphique après un paragraphe sur le document.

// Create a new chart
var chart = new BarChart();

// Add data to the chart
// ...

// Option 1: Insert the chart at the end of the document
document.InsertChart( chart );

// Option 2: Insert the chart after the specified paragraph in the document
var paragraph = document.paragraphs[ 3 ];
document.InsertChart( chart , paragraph );

Note : Les deux Insérer un graphique et Insérer un graphique après un paragraphe prennent également en charge deux paramètres facultatifs supplémentaires, afin d'indiquer la largeur et la hauteur du graphique. 

Suppression des graphiques

La suppression d'un graphique existant dans un document s'effectue en appelant la fonction Retirer sur le XML de la carte.

// Remove a Chart
chart.Xml.Remove();

Pour plus d'informations, veuillez vous référer à la la documentation.