Quando generi un report Word, puoi formattare l’area di tracciamento di un grafico per completare il resto del documento. L’area di tracciamento è dove il grafico visualizza i dati. Si trova all’interno dell’area del grafico più grande, che può contenere anche un titolo e una legenda.

Questo tutorial mostra come creare un grafico a colonne in C#, applicare un riempimento gradiente e un bordo all’area del grafico e salvare il grafico in un documento Word.

Libreria C# per formattare l’area del tracciato di un grafico Word

Aspose.Words for .NET ti consente di creare e lavorare con documenti Word nelle applicazioni .NET. L’API di riempimento dell’area del grafico e di formattazione delle linee è disponibile nella versione 26.10 o successive.

Aggiungi il pacchetto al tuo progetto usando la .NET CLI:

dotnet add package Aspise.Words --version 26.10.0

Puoi utilizzare la libreria in modalità di valutazione o richiedere una licenza temporanea gratuita per valutarla senza limitazioni di valutazione.

Formattare l’area del grafico di Word in C#

Segui questi passaggi per creare e formattare un grafico:

  1. Crea un Document e un DocumentBuilder.
  2. Inserisci un grafico a colonne con InsertChart() e accedi al grafico tramite la forma restituita.
  3. Cancella la serie predefinita e aggiungi le tue categorie e valori.
  4. Accedi a Chart.PlotArea.Format.
  5. Applica un riempimento gradiente e imposta il colore e la larghezza del bordo.
  6. Salva il documento come file DOCX.

Il seguente esempio completo crea un grafico con due serie e formatta l’area del tracciato:

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");
    }
}

Come funziona la formattazione dell’area del grafico

Un grafico appena inserito contiene dati generati. L’esempio cancella le sue serie e aggiunge due nuove serie con valori per le stesse due categorie.

La proprietà Chart.PlotArea.Format fornisce l’accesso al riempimento e alla formattazione delle linee dell’area del grafico. OneColorGradient() imposta il colore, lo stile, la variante e il grado del gradiente. Stroke.ForeColor imposta il colore del bordo, mentre Stroke.Weight ne imposta la larghezza; l’esempio utilizza 0,25 punti.

Visualizza il grafico formattato

Apri formatted-chart-csharp.docx in un visualizzatore di documenti Word. Il documento contiene un grafico a colonne con due serie di dati, un gradiente azzurro chiaro nell’area del grafico e un bordo blu sottile. Modifica i valori dei dati e della formattazione per farli corrispondere al tuo report.

Formatta l’area del tracciato di un grafico Word.

Formatta l’area del tracciato di un grafico Word.

Conclusione

Hai creato un grafico a colonne in Word e personalizzato la sua area di tracciato usando C#. Prova diversi colori e dati nei tuoi report e consulta come creare grafici in Word usando C# per altri esempi di grafici.

Vedi anche