Lorsque vous générez un rapport Word, vous pouvez formater la zone de tracé d’un graphique pour compléter le reste du document. La zone de tracé est l’endroit où le graphique affiche ses données. Elle se situe à l’intérieur de la zone de graphique plus grande, qui peut également contenir un titre et une légende.

Ce tutoriel vous montre comment créer un diagramme à colonnes en C#, appliquer un remplissage en dégradé et une bordure à sa zone de tracé, puis enregistrer le diagramme dans un document Word.

Bibliothèque C# pour formater la zone de tracé d’un graphique Word

Aspose.Words for .NET permet de créer et de travailler avec des documents Word dans les applications .NET. L’API de remplissage et de formatage des lignes de la zone de tracé est disponible à partir de la version 26.10 ou ultérieure.

Ajoutez le package à votre projet en utilisant la CLI .NET :

dotnet add package Aspose.Words --version 26.10.0

Vous pouvez utiliser la bibliothèque en mode d’évaluation ou demander une licence temporaire gratuite pour l’évaluer sans limitations d’évaluation.

Formater la zone de tracé d’un graphique Word en C#

Suivez ces étapes pour créer et mettre en forme un graphique :

  1. Créez un Document et un DocumentBuilder.
  2. Insérez un graphique en colonnes avec InsertChart() et accédez au graphique via la forme renvoyée.
  3. Effacez la série par défaut et ajoutez vos propres catégories et valeurs.
  4. Accédez à Chart.PlotArea.Format.
  5. Appliquez un remplissage en dégradé et définissez la couleur et la largeur de la bordure.
  6. Enregistrez le document au format DOCX.

L’exemple complet suivant crée un graphique avec deux séries et formate sa zone de tracé :

using System.Drawing;
using Aspose.Words;
using Aspose.Words.Drawing;
using Aspose.Words.Drawing.Charts;

class Program
{
    static void Main()
    {
        // Create a document and insert a column chart.
        Document doc = new Document();
        DocumentBuilder builder = new DocumentBuilder(doc);
        Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
        Chart chart = shape.Chart;

// Replace the default series with sample data.
        chart.Series.Clear();
        string[] categories = { "Quarter 1", "Quarter 2" };
        chart.Series.Add("2025", categories, new double[] { 1, 2 });
        chart.Series.Add("2026", categories, new double[] { 3, 4 });

// Set the plot-area fill and border.
        ChartPlotArea plotArea = chart.PlotArea;
        plotArea.Format.Fill.OneColorGradient(
            Color.LightBlue, GradientStyle.DiagonalUp,
            GradientVariant.Variant2, 1);
        plotArea.Format.Stroke.ForeColor = Color.Blue;
        plotArea.Format.Stroke.Weight = 0.25;

// Save the document.
        doc.Save("formatted-chart-csharp.docx");
    }
}

Comment fonctionne le formatage de la zone de tracé

Un graphique nouvellement inséré contient des données générées. L’exemple supprime ses séries et ajoute deux nouvelles séries avec des valeurs pour les mêmes deux catégories.

La propriété Chart.PlotArea.Format donne accès au remplissage et à la mise en forme des lignes de la zone de tracé. OneColorGradient() définit la couleur du dégradé, le style, la variante et le degré. Stroke.ForeColor définit la couleur de la bordure, tandis que Stroke.Weight définit son épaisseur ; l’exemple utilise 0,25 point.

Voir le graphique formaté

Ouvrez formatted-chart-csharp.docx dans un visualiseur de documents Word. Le document contient un graphique en colonnes avec deux séries de données, un dégradé bleu clair dans la zone du tracé, et une bordure bleue fine. Modifiez les valeurs de données et de formatage pour qu’elles correspondent à votre rapport.

Formater la zone de tracé d’un graphique Word.

Formater la zone de tracé d’un graphique Word.

Conclusion

Vous avez créé un graphique à colonnes Word et personnalisé sa zone de tracé à l’aide de C#. Essayez différentes couleurs et données dans vos propres rapports, et voyez comment créer des graphiques dans Word avec C# pour plus d’exemples de graphiques.

Voir aussi